boolean $DB_DataObject->getLinks (
string $variableFormat
)
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.
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
Exemple de formattage
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');
boolean - TRUE en cas de succès, FALSE si une erreur survient.
This function can not be called statically.
Exemple avec deux tables
Chargement de tous les objets relatifs
<?php
$person = new DataObjects_Person;
$person->get(1079);
$person->getLinks();
print_r($person);
?>
SQL résultant
Affichage résultant
Exemple avec une jointure sur trois tables
<?php
/**
* 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);
?>
databasename.links.ini