manual/codes/Basic Components - Collection - Loading related records.php

@@ -0,0 +1,20 @@
+<?php
+$users = $session->query("FROM User");
+
+// now lets load phonenumbers for all users
+
+$users->loadRelated("Phonenumber");
+
+foreach($users as $user) {
+    print $user->Phonenumber->phonenumber;
+    // no additional db queries needed here
+}
+
+// the loadRelated works an any relation, even associations:
+
+$users->loadRelated("Group");
+
+foreach($users as $user) {
+    print $user->Group->name;
+}
+?>

manual/docs/Basic Components - Collection - Loading related records.php

@@ -0,0 +1,3 @@
+Doctrine provides means for effiently 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.