From 406e78bcf5bfbaa8599e63c2d98397fd1cc4f8fe Mon Sep 17 00:00:00 2001 From: zYne Date: Mon, 6 Aug 2007 20:20:40 +0000 Subject: [PATCH] --- .../dealing-with-relations.txt | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/manual/new/docs/en/working-with-objects/dealing-with-relations.txt b/manual/new/docs/en/working-with-objects/dealing-with-relations.txt index 8ac5f7469..070657d74 100644 --- a/manual/new/docs/en/working-with-objects/dealing-with-relations.txt +++ b/manual/new/docs/en/working-with-objects/dealing-with-relations.txt @@ -23,7 +23,7 @@ $user->Email->address = 'some@one.info'; $user->save(); -When accessing one-to-many related records, Doctrine creates a Doctrine_Collection for the related component. Lets say we have users and phonenumbers and their relations is one-to-many. You can add phonenumbers easily as shown above: +When accessing one-to-many related records, Doctrine creates a Doctrine_Collection for the related component. Lets say we have users and phonenumbers and their relation is one-to-many. You can add phonenumbers easily as shown above: $user = new User(); @@ -67,7 +67,7 @@ $user->save(); +++ Deleting related records -You can delete related records individually be calling {{delete()}} on each record. If you want to delete a whole record graph just call delete on the owner record. +You can delete related records individually be calling {{delete()}} on a record or on a collection. $user->Email->delete(); @@ -78,3 +78,18 @@ $user->Phonenumber[3]->delete(); $user->delete(); + +Usually in a typical web application the primary keys of the related objects that are to be deleted come from a form. In this case the most efficient way of deleting the related records is using DQL DELETE statement. Lets say we have once again users and phonenumbers with their relation being one-to-many. Deleting the given phonenumbers for given user id can be achieved as follows: + + +$deleted = Doctrine_Query::create() + ->delete() + ->from('Phonenumber') + ->addWhere('user_id = ?', array($userId)) + ->whereIn('group_id', $groupIds); + ->execute(); +// print out the number of deleted phonenumbers +print $deleted; + + +