Zum Inhalt springen
Dokumentation · Integrationen

Doctrine ORM

Behaviors an Entities von Doctrine ORM 3.6+: Entity-Discovery mit WovenEntityClassLocator und abgefangene Properties mit nativen Lazy Objects.

Aus dem Englischen übersetzt. Maßgeblich ist die englische Seite. Original lesen

Doctrine ORM (3.6+) mappt eine kompilierte Entity so, wie sie ist. Die kompilierte Klasse behält ihren Namen und alle Mapping-Attribute, und der ursprüngliche Klassenrumpf liegt in einem Trait, den Doctrine nie mappt. Sie konfigurieren zwei Dinge. In Symfony erledigt das Bundle beides für Sie (siehe Symfony).

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

Bekommt Doctrine einfache Verzeichnisse, bindet es die Quelldateien der Entities direkt ein. Das umgeht den Compiler, die Entity verliert also ihre Behaviors (Verhalten), und Doctrine übersieht Entities, die der Autoloader bereits geladen hat. WovenEntityClassLocator liest die Klassennamen aus den Quelldateien und lädt jede Klasse über den Autoloader, der die kompilierte Version ausliefert.

use Doctrine\ORM\Events;
use Go\Bridge\Doctrine\MetadataLoadInterceptor;
$configuration->enableNativeLazyObjects(true);
$eventManager->addEventListener(Events::loadClassMetadata, new MetadataLoadInterceptor());

Eine abgefangene Property wird mit nativen Property-Hooks neu deklariert, und Doctrine unterstützt diese nur mit nativen Lazy Objects. Schalten Sie sie ein. MetadataLoadInterceptor zu registrieren ist optional: Wenn native Lazy Objects ausgeschaltet sind, meldet er eine kompilierte Entity mit abgefangenen gemappten Properties schon beim Laden der Metadaten, statt erst am ersten Lazy Proxy zu scheitern.

Doctrine liest und schreibt beim Hydrieren und Flushen die rohen Property-Werte. Behaviors an Properties laufen deshalb nur für Zugriffe aus Ihrem eigenen Code, nie für die internen Zugriffe von Doctrine.

© 2026 Alexander Lisachenko