Перейти к содержимому
Документация · Интеграции

Doctrine ORM

Поведения на сущностях Doctrine ORM 3.6+: обнаружение сущностей через WovenEntityClassLocator и перехват свойств с нативными ленивыми объектами.

Перевод с английского. Эталоном считается английская версия страницы. Читать оригинал

Doctrine ORM (3.6+) отображает скомпилированную сущность как есть. Скомпилированный класс сохраняет своё имя и все атрибуты маппинга, а исходное тело класса живёт в трейте, который Doctrine никогда не отображает. Настроить нужно две вещи. В Symfony бандл делает и то и другое за вас (см. Symfony).

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

Если передать Doctrine просто каталоги, она подключает исходные файлы сущностей напрямую. Это обходит компилятор, поэтому сущность теряет свои behaviors (поведения), а сущности, которые автозагрузчик уже загрузил, Doctrine пропускает. WovenEntityClassLocator читает имена классов из исходных файлов и загружает каждый класс через автозагрузчик, который отдаёт скомпилированную версию.

Перехват свойств и нативные ленивые объекты

Заголовок раздела «Перехват свойств и нативные ленивые объекты»
use Doctrine\ORM\Events;
use Go\Bridge\Doctrine\MetadataLoadInterceptor;
$configuration->enableNativeLazyObjects(true);
$eventManager->addEventListener(Events::loadClassMetadata, new MetadataLoadInterceptor());

Перехваченное свойство заново объявляется с нативными хуками свойств, а Doctrine поддерживает их только с нативными ленивыми объектами. Включите их. Регистрировать MetadataLoadInterceptor не обязательно: если нативные ленивые объекты выключены, он сообщает о скомпилированной сущности с перехваченными отображаемыми свойствами ещё при загрузке метаданных, а не падает на первом ленивом прокси.

Doctrine читает и пишет сырые значения свойств при гидрации и сохранении. Поэтому behaviors на свойствах выполняются только при обращениях из вашего собственного кода и никогда — при внутренних обращениях Doctrine.

© 2026 Alexander Lisachenko