Doctrine_manual-1-2-en

Chapter 8: Working with Models 105
Updating Related Records
You can update the related records by calling save for each related object / collection
individually or by calling save on the object that owns the other objects. You can also call
Doctrine_Connection::flush which saves all pending objects.
// test.php
Listing
8-18
// ...
$user->Email['address'] = 'koskenkorva@drinkmore.info';
$user->Phonenumbers[0]['phonenumber'] = '123123';
$user->save();
In the above example calling $user->save() saves the email and phonenumber.
Clearing Related Records
You can clear a related records references from an object. This does not change the fact that
these objects are related and won't change it in the database if you save. It just simply clears
the reference in PHP of one object to another.
You can clear all references by doing the following:
// test.php
Listing
8-19
// ...
$user->clearRelated();
Or you can clear a specific relationship:
// test.php
Listing
8-20
// ...
$user->clearRelated('Email');
This is useful if you were to do something like the following:
// test.php
Listing
8-21
// ...
if ($user->Email->exists()) {
// User has e-mail
} else {
// User does not have a e-mail
}
$user->clearRelated('Email');
Because Doctrine will automatically create a new Email object if the user does not have one,
we need to clear that reference so that if we were to call $user->save() it wouldn't save a
blank Email record for the User.
----------------- Brought to you by