Supprimer des Données¶

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é.

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 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:

$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 Méthodes Callback pour plus d’informations.

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.

• conditions Conditions pour matcher.

• cascade Booléen, Mis à true pour supprimer les enregistrements qui dépendent de cet enregistrement.

• callbacks Booléen, Lance les callbacks

Retourne un booléen true en cas de succès, false en cas d’échec.

Exemple:

// Suppression avec un tableau de conditions similaires à find()
$this->Comment->deleteAll(array('Comment.spam' => true), false);

Si vous supprimez avec soit callbacks et/ou cascade, les lignes seront trouvées et ensuite supprimées. Cela impliquera souvent plus de requêtes faîtes. Les associations vont être réinitialisées avant que les enregistrements correspondants ne soient supprimés dans deleteAll(). Si vous utilisez bindModel() ou unbindModel() pour changer les associations, vous devrez définir reset à false.