Charge tous les objets relatifs dans l'objet principal, en utilisant les relations
du fichier links.ini, et définit les variables de l'objet appelé avec le nom de la
ligne préfixée avec un underscore (_) dans l'objet résultant.
L'utilisation de cette méthode avec la convention de nommage des colonnes
est obsolète ; les fichiers links.ini doivent être utilisés à la place.
Paramètres
string $variableFormat - le comportement par défaut
est d'assigner les objets résultants aux variables, avec le nom des lignes préfixé avec
un underscore (_), cependant, vous pouvez utiliser cette valeur
pour fomatter la variable différemment
Si room.occupied_by est lié à person.id
sans modificateur - e.g. _%s
Les résultats dans l'équivalent de
$object->_occupied_by = $object->getLink('occupied_by');
avec un modificateur - e.g. link_%s
Les résultats dans l'équivalent de
$object->link_occupied_by = $object->getLink('occupied_by');
Valeur retournée
boolean - TRUE en cas de succès, FALSE si une erreur survient
Note
Cette fonction ne peut pas être appelée de façon statique.
/**
* L'exemple suivant montre une jointure sur trois tables
*
*/
$person = new DataObjects_Person;
$data = array();
if ($person->find()) {
while ($person->fetch()) {
$person->getLinks();
// Ce qui suit est un autre appel à getLinks pour la seconde jointure
$person->_convention_id->getLinks();
$data[] = $person->_convention_id->_room_id->ToArray();
}
}
print_r($data);
; ce fichier ini est pour l'exemple de jointure sur trois tables, ci-dessus
[person]
person_id = convention:person_id
[room]
room_id = convention:room_id
