Symfony Publié le

Filtrer sans tronquer les collections

Un WHERE sur une jointure chargée avec addSelect() laisse les collections incomplètes, et elles restent ainsi dans l'EntityManager. EXISTS filtre sans rien couper.

Notions abordées : DoctrineRelationsQueryBuilderRequêtes N+1

Au café, certaines lignes de commande sont offertes. Ce matin, Ada a pris deux cafés, un thé et un croissant offert : sa facture fait 8,00 €. Le patron veut la liste des commandes qui ont au moins une ligne offerte, avec leurs lignes, en une seule requête pour éviter le N+1. CommandeRepository::avecUneLigneOfferte() s'y prend ainsi :

$this->createQueryBuilder('c')
    ->join('c.lignes', 'l')
    ->addSelect('l')
    ->where('l.offerte = true')
    ->orderBy('c.id')
    ->getQuery()
    ->getResult();

La liste contient bien les bonnes commandes, celles d'Ada et d'Alan. Mais regardez les lignes d'Ada dans l'aperçu (les totaux sont en centimes) :

{ "client": "Ada", "lignes": ["Croissant"], "total": 0 }

Il ne reste que le croissant. Le WHERE a servi à deux choses à la fois. Il a choisi les commandes, ce qu'on voulait. Mais il a aussi filtré les lignes que la jointure renvoie, et avec addSelect('l'), ce sont ces lignes-là que Doctrine range dans getLignes(). Il tient ensuite la collection pour complète et ne la relira pas.

Le bug ne s'arrête pas à la liste. La commande d'Ada reste dans l'EntityManager. Quand le contrôleur édite ensuite sa facture avec findOneBy(), Doctrine renvoie le même objet, avec la même collection tronquée : une facture à 0 € au lieu de 8 €. Dans une commande console ou un worker Messenger, où l'EntityManager vit longtemps, ce genre d'erreur apparaît loin de sa cause.

Il faut donc séparer les deux rôles : une condition qui choisit les commandes sans toucher à la jointure, et une jointure qui remplit les collections sans filtre. En DQL, une condition comme EXISTS (sous-requête) sait faire le premier travail.

À faire

L'aperçu /commandes/avec-offre liste les commandes du jour qui ont une ligne offerte, puis édite la facture d'Ada avec findOneBy().

  1. Corrigez CommandeRepository::avecUneLigneOfferte() pour que chaque commande garde toutes ses lignes.
  2. Gardez une seule requête SQL pour la liste et ses lignes.

Le contrôleur et les entités ne changent pas.