PEAR Manual
Prev		Next

->getLink()

->getLink() -- fetch and return a related object

Synopsis

mixed $DB_DataObject->getLink (string $row [, string $table [, string $key]])

Description

Fetch a related object. This should be used in conjunction with a <dbname>.links.ini file configuration (see the introduction on linking for details on this).

You may also use this with all parameters to specify, the row, and related table and row.

Parameter

string $row - either row or row.xxxxx
string $table - name of table to look up value in
string $link - name of column in other table to match

Return value

mixed - object on success or FALSE on failure.

Note

This function can not be called statically.

Example

Example 21-1. Getting the related object

$person = new DataObjects_Person; $person->get(12); $group = $person->getLink('group_owner'); echo $group->name; $group = $person->getLink('colourid','hair');

Example 21-2. Resulting SQL

SELECT * FROM person WHERE id=12 SELECT * FROM group WHERE id=3 SELECT * FROM hair WHERE id=4

Prev	Home	Next
Automatic Table Linking and Joins	Up	->getLinks()

Who's Online
Guest Users: 8

Free Sample Chapters
	Deliver First Class Web Sites: 101 Essential Checklists Want to learn how to make your web sites usable and accessible? Want to ensure that your sites meet current best practice, without spending hours trawling through incomprehensible specifications and recommendations from dozens of different books, research papers, and web sites? Want to make sure that the sites you build are "right the first time," requiring no costly redevelopments?
More Sample Chapters

PHP General