From fe9c4d18b88225b9ad280c4a114f3dc084ce5049 Mon Sep 17 00:00:00 2001 From: cake17 Date: Fri, 4 Mar 2016 15:04:22 +0100 Subject: [PATCH] [fr] #3786 --- en/models/deleting-data.rst | 33 +++++++++++++-------------- fr/models/deleting-data.rst | 45 ++++++++++++++++++++----------------- 2 files changed, 41 insertions(+), 37 deletions(-) diff --git a/en/models/deleting-data.rst b/en/models/deleting-data.rst index 7dd693f589..522fd75be4 100644 --- a/en/models/deleting-data.rst +++ b/en/models/deleting-data.rst @@ -10,16 +10,16 @@ delete ``delete(integer $id = null, boolean $cascade = true);`` -Deletes the record identified by $id. By default, also deletes -records dependent on the record specified to be deleted. +Deletes the record identified by $id. By default, also deletes records dependent +on the record specified to be deleted. -For example, when deleting a User record that is tied to many -Recipe records (User 'hasMany' or 'hasAndBelongsToMany' Recipes): +For example, when deleting a User record that is tied to many Recipe records +(User 'hasMany' or 'hasAndBelongsToMany' Recipes): -- if $cascade is set to true, the related Recipe records are also - deleted if the model's dependent-value is set to true. -- if $cascade is set to false, the Recipe records will remain - after the User has been deleted. +- if $cascade is set to true, the related Recipe records are also deleted if + the model's dependent-value is set to true. +- if $cascade is set to false, the Recipe records will remain after the User + has been deleted. If your database supports foreign keys and cascading deletes, it's often more efficient to rely on that feature than CakePHP's cascading. The one benefit to @@ -34,9 +34,10 @@ You can hook custom logic into the delete process using the ``beforeDelete`` and .. note:: - If you delete a record with dependent records and one of their delete callbacks, - e.g. ``beforeDelete`` returns ``false``, it will not stop the further event - propagation nor does it change the return value of the initial ``delete``. + If you delete a record with dependent records and one of their delete + callbacks, e.g. ``beforeDelete`` returns ``false``, it will not stop the + further event propagation nor does it change the return value of the initial + ``delete``. .. _model-deleteall: @@ -45,14 +46,12 @@ deleteAll ``deleteAll(mixed $conditions, $cascade = true, $callbacks = false)`` -``deleteAll()`` is similar to ``delete()``, except that -``deleteAll()`` will delete all records that match the supplied -conditions. The ``$conditions`` array should be supplied as a SQL -fragment or array. +``deleteAll()`` is similar to ``delete()``, except that ``deleteAll()`` will +delete all records that match the supplied conditions. The ``$conditions`` array +should be supplied as a SQL fragment or array. * **conditions** Conditions to match -* **cascade** Boolean, Set to true to delete records that depend on - this record +* **cascade** Boolean, Set to true to delete records that depend on this record * **callbacks** Boolean, Run callbacks Return boolean True on success, false on failure. diff --git a/fr/models/deleting-data.rst b/fr/models/deleting-data.rst index f2ab2775a0..7aac6d07a4 100644 --- a/fr/models/deleting-data.rst +++ b/fr/models/deleting-data.rst @@ -11,31 +11,37 @@ delete ``delete(integer $id = null, boolean $cascade = true);`` -Supprime l'enregistrement identifié par $id. Par défaut, supprime -également les enregistrements dépendants de l'enregistrement -mentionné comme devant être supprimé. +Supprime l'enregistrement identifié par $id. Par défaut, supprime également les +enregistrements dépendants de l'enregistrement mentionné comme devant être +supprimé. -Par exemple, lors de la suppression d'un enregistrement User -lié à plusieurs enregistrements Recipe (User 'hasMany' ou -'hasAndBelongsToMany' Recipes): +Par exemple, lors de la suppression d'un enregistrement User lié à plusieurs +enregistrements Recipe (User 'hasMany' ou 'hasAndBelongsToMany' Recipes): - si $cascade est fixée à true, les entrées Recipe liées sont aussi supprimées si les valeurs "dependant" des models sont à true. - - si $cascade est fixée à false, les entrées Recipe resteront après - que l'User ait été supprimé. + - si $cascade est fixée à false, les entrées Recipe resteront après que + l'User a été supprimé. Si votre base de données permet les clés étrangères et les suppressions en cascade, il est souvent plus efficace de les utiliser plutôt que le cascade -de CakePHP. Le seul bénéfice pour l'utilisation de la fonctionnalité de -cascade de ``Model::delete()`` est qu'elle vous permet d'influencer les -callbacks des behaviors et des Models:: +de CakePHP. Le seul bénéfice pour l'utilisation de la fonctionnalité de cascade +de ``Model::delete()`` est qu'elle vous permet d'influencer les callbacks des +behaviors et des Models:: $this->Comment->delete($this->request->data('Comment.id')); -Vous pouvez brancher une logique personnalisée dans le processus de -suppression à l'aide des callbacks ``beforeDelete`` et ``afterDelete`` -présents dans les deux Models et Behaviors. Allez voir -:doc:`/models/callback-methods` pour plus d'informations. +Vous pouvez brancher une logique personnalisée dans le processus de suppression +à l'aide des callbacks ``beforeDelete`` et ``afterDelete`` présents dans les +deux Models et Behaviors. Allez voir :doc:`/models/callback-methods` pour plus +d'informations. + +.. note:: + + Si vous supprimez un enregistrement avec des enregistrements dépendants et + que l'un des callbacks de suppression, par exemple ``beforeDelete`` retourne + ``false``, il ne va pas stopper l'event de propagation suivant ni changer + la valeur de retour du ``delete`` initial. .. _model-deleteall: @@ -44,10 +50,9 @@ deleteAll ``deleteAll(mixed $conditions, $cascade = true, $callbacks = false)`` -``deleteAll()`` est identique à ``delete()``, sauf que -``deleteAll()`` supprimera tous les enregistrements qui matchent les conditions -fournies. Le tableau ``$conditions`` doit être fourni en tant que fragment ou -tableau SQL. +``deleteAll()`` est identique à ``delete()``, sauf que ``deleteAll()`` +supprimera tous les enregistrements qui matchent les conditions fournies. Le +tableau ``$conditions`` doit être fourni en tant que fragment ou tableau SQL. * **conditions** Conditions pour matcher. * **cascade** Booléen, Mis à true pour supprimer les enregistrements qui @@ -73,7 +78,7 @@ bindModel() ou unbindModel() pour changer les associations, vous devrez définir deleteAll() retournera true même si aucun enregistrement n'est supprimé, puisque les conditions pour la requête de suppression est un succès et qu'aucun enregistrement correspondant ne reste. - + .. meta:: :title lang=fr: Supprimer des Données