Doctrine ORM
Behaviors en entidades de Doctrine ORM 3.6+: descubrimiento de entidades con WovenEntityClassLocator y propiedades interceptadas con lazy objects nativos.
Traducido del inglés. La página en inglés es la referencia. Leer el original
Doctrine ORM (3.6+) mapea una entidad compilada tal cual. La clase compilada conserva su nombre y todos los atributos de mapeo, y el cuerpo original de la clase vive en un trait que Doctrine nunca mapea. Configuras dos cosas. En Symfony, el bundle hace ambas por ti (consulta Symfony).
Descubrimiento de entidades
Sección titulada «Descubrimiento de entidades»use Doctrine\ORM\Mapping\Driver\AttributeDriver;use Go\Bridge\Doctrine\WovenEntityClassLocator;
$configuration->setMetadataDriverImpl( new AttributeDriver(WovenEntityClassLocator::createFromDirectories([__DIR__ . '/src/Entity'])),);Si le das directorios sin más, Doctrine incluye directamente los archivos fuente de las entidades. Eso se salta el compilador, así que la entidad pierde sus behaviors (comportamientos), y Doctrine no ve las entidades que el autoloader ya ha cargado. WovenEntityClassLocator lee los nombres de clase de los archivos fuente y carga cada clase a través del autoloader, que sirve la versión compilada.
Propiedades interceptadas y lazy objects nativos
Sección titulada «Propiedades interceptadas y lazy objects nativos»use Doctrine\ORM\Events;use Go\Bridge\Doctrine\MetadataLoadInterceptor;
$configuration->enableNativeLazyObjects(true);$eventManager->addEventListener(Events::loadClassMetadata, new MetadataLoadInterceptor());Una propiedad interceptada se vuelve a declarar con property hooks nativos, y Doctrine solo los admite con lazy objects nativos. Actívalos. Registrar MetadataLoadInterceptor es opcional: cuando los lazy objects nativos están desactivados, informa al cargar los metadatos de una entidad compilada con propiedades mapeadas interceptadas, en lugar de fallar con el primer lazy proxy.
Doctrine lee y escribe los valores en bruto de las propiedades al hidratar y al hacer flush. Por eso los behaviors en propiedades solo se ejecutan en los accesos que hace tu propio código, nunca en los accesos internos de Doctrine.
© 2026 Alexander Lisachenko
