Doctrine_manual-1-2-en

Chapter 10: Component Overview 182
Listing
10-87
// test.php
// ...
$userTable = Doctrine_Core::getTable('User');
$userTable->setAttribute(Doctrine_Core::ATTR_COLL_KEY, 'username');
Now user collections will use the values of name column as element indexes:
Listing
10-88
// test.php
// ...
$users = $userTable->findAll();
foreach($users as $username => $user) {
echo $username . ' - ' . $user->created_at . "\n";
}
Note this would only be advisable if the username column is specified as unique in your
schema otherwise you will have cases where data cannot be hydrated properly due to
duplicate collection keys.
Loading Related Records
Doctrine provides means for efficiently retrieving all related records for all record elements.
That means when you have for example a collection of users you can load all phonenumbers
for all users by simple calling the loadRelated() method.
However, in most cases you don't need to load related elements explicitly, rather what you
should do is try to load everything at once by using the DQL API and JOINS.
The following example uses three queries for retrieving users, their phonenumbers and the
groups they belong to.
Listing
10-89
// test.php
// ...
$q = Doctrine_Query::create()
->from('User u');
$users = $q->execute();
Now lets load phonenumbers for all users:
Listing
10-90
// test.php
// ...
$users->loadRelated('Phonenumbers');
foreach($users as $user) {
echo $user->Phonenumbers[0]->phonenumber;
// no additional db queries needed here
}
The loadRelated() works an any relation, even associations:
Listing
10-91
----------------- Brought to you by