Aller au contenu
Documentation · Intégrations

Doctrine ORM

Des behaviors sur les entités Doctrine ORM 3.6+ : découverte des entités avec WovenEntityClassLocator et propriétés interceptées avec les objets paresseux natifs.

Traduit de l’anglais. La page anglaise fait référence. Lire l’original

Doctrine ORM (3.6+) mappe une entité compilée telle quelle. La classe compilée garde son nom et tous ses attributs de mapping, et le corps de la classe d’origine vit dans un trait que Doctrine ne mappe jamais. Vous avez deux choses à configurer. Sous Symfony, le bundle s’occupe des deux à votre place (voir Symfony).

use Doctrine\ORM\Mapping\Driver\AttributeDriver;
use Go\Bridge\Doctrine\WovenEntityClassLocator;
$configuration->setMetadataDriverImpl(
new AttributeDriver(WovenEntityClassLocator::createFromDirectories([__DIR__ . '/src/Entity'])),
);

Avec de simples répertoires, Doctrine inclut directement les fichiers sources des entités. Cela contourne le compilateur : l’entité perd ses behaviors (comportements), et Doctrine manque les entités que l’autoloader a déjà chargées. WovenEntityClassLocator lit les noms de classes dans les fichiers sources et charge chaque classe via l’autoloader, qui sert la version compilée.

Propriétés interceptées et objets paresseux natifs

Section intitulée « Propriétés interceptées et objets paresseux natifs »
use Doctrine\ORM\Events;
use Go\Bridge\Doctrine\MetadataLoadInterceptor;
$configuration->enableNativeLazyObjects(true);
$eventManager->addEventListener(Events::loadClassMetadata, new MetadataLoadInterceptor());

Une propriété interceptée est redéclarée avec des property hooks natifs, et Doctrine ne les prend en charge qu’avec les objets paresseux natifs (native lazy objects). Activez-les. L’enregistrement de MetadataLoadInterceptor est facultatif : quand les objets paresseux natifs sont désactivés, il signale dès le chargement des métadonnées une entité compilée dont des propriétés mappées sont interceptées, au lieu d’échouer sur le premier proxy paresseux.

Doctrine lit et écrit les valeurs brutes des propriétés pendant l’hydratation et le flush. Les behaviors sur les propriétés ne s’exécutent donc que pour les accès faits par votre propre code, jamais pour les accès internes de Doctrine.

© 2026 Alexander Lisachenko