Comment effectuer des jointures à gauche dans Doctrine

Lorsque vous travaillez avec des modèles de données complexes, il devient nécessaire de récupérer les données de plusieurs tables en établissant des relations entre elles. Les jointures gauches vous permettent de récupérer toutes les lignes d'une table et uniquement les lignes correspondantes de l'autre table.

Problème rencontré

Une erreur courante qui peut survenir lors d'une tentative de jointure gauche dans Doctrine est la réception l'erreur de syntaxe suivante : 

[Erreur de syntaxe] ligne 0, col 98 : Erreur : Attendue Doctrine\ORM\Query\Lexer::T_WITH, got 'ON'

Cette erreur se produit lorsque "ON" est utilisé dans la clause de jointure au lieu de "WITH". Pour résoudre ce problème, remplacez "ON" par "WITH" comme indiqué ci-dessous :

$qb->leftJoin('User\Entity\User', 'u', \Doctrine\ORM\Query\Expr\Join::WITH, 'a.user = u.id')

Implémentation des jointures à gauche

Pour effectuer une jointure à gauche dans Doctrine, il existe deux approches :

Avec une association :

Si votre entité a une association avec la table que vous souhaitez rejoindre, vous pouvez utiliser la syntaxe suivante :

$qb
    ->select('a', 'u')
    ->from('Credit\Entity\UserCreditHistory', 'a')
    ->leftJoin('a.user', 'u')
    ->where('u = :user')
    ->setParameter('user', $users)
    ->orderBy('a.created_at', 'DESC');

Dans ce cas, "Credit\Entity\UserCreditHistory#user" représente l'association entre les deux entités.

Sans association :

Si aucune association n'existe, vous pouvez utiliser ce qui suit syntaxe :

$qb
    ->select('a', 'u')
    ->from('Credit\Entity\UserCreditHistory', 'a')
    ->leftJoin(
        'User\Entity\User',
        'u',
        \Doctrine\ORM\Query\Expr\Join::WITH,
        'a.user = u.id'
    )
    ->where('u = :user')
    ->setParameter('user', $users)
    ->orderBy('a.created_at', 'DESC');

Cette requête récupère les enregistrements des deux tables et renvoie un jeu de résultats contenant des tableaux au format suivant :

array(
    array(
        0 => UserCreditHistory instance,
        1 => Userinstance,
    ),
    array(
        0 => UserCreditHistory instance,
        1 => Userinstance,
    ),
    // ...
)