Symfony – Cascade persist et remove

Cours 19 — Cascade persist et remove

Introduction

Les options cascade permettent à Doctrine d’effectuer automatiquement certaines opérations sur les entités liées.

Les plus utilisées sont :

persist
remove

---

Cascade persist

Sans cascade :

$patient->addSejour($sejour);

$entityManager->persist($patient);
$entityManager->persist($sejour);
$entityManager->flush();

---

Avec cascade persist

#[ORM\OneToMany(
    targetEntity: Sejour::class,
    mappedBy: 'patient',
    cascade: ['persist']
)]
private Collection $sejours;

Puis :

$patient->addSejour($sejour);

$entityManager->persist($patient);
$entityManager->flush();

Doctrine enregistre automatiquement le séjour.

---

Cascade remove

Sans cascade :

$entityManager->remove($sejour);
$entityManager->remove($patient);
$entityManager->flush();

---

Avec cascade remove

#[ORM\OneToMany(
    targetEntity: Sejour::class,
    mappedBy: 'patient',
    cascade: ['remove']
)]
private Collection $sejours;

Puis :

$entityManager->remove($patient);
$entityManager->flush();

Doctrine supprime automatiquement les séjours liés.

---

Utiliser plusieurs cascades

#[ORM\OneToMany(
    targetEntity: Sejour::class,
    mappedBy: 'patient',
    cascade: ['persist', 'remove']
)]
private Collection $sejours;

---

Comprendre le fonctionnement

Patient
↓
Séjours

Avec :

cascade persist

l’enregistrement du patient entraîne l’enregistrement des séjours.

Avec :

cascade remove

la suppression du patient entraîne la suppression des séjours.

---

Attention

Une cascade remove peut supprimer un grand nombre d’enregistrements.

Il faut l’utiliser avec prudence.

---

Conclusion

Les cascades automatisent certaines opérations Doctrine.

À retenir :

• persist : enregistrement automatique ;
• remove : suppression automatique ;
• plusieurs cascades peuvent être combinées ;
• attention aux suppressions en cascade.