Doctrine ORM
在 Doctrine ORM 3.6+ 实体上使用 behavior:用 WovenEntityClassLocator 发现实体,用原生惰性对象支持被拦截的属性。
本页译自英文,以英文页面为准。 阅读原文
Doctrine ORM(3.6+)会原样映射编译后的实体。编译后的类保留原来的类名和全部映射注解,原始的类体则放在一个 trait 中,而 Doctrine 从不映射这个 trait。你需要配置两件事。在 Symfony 中,bundle 会替你把两件事都做好(见 Symfony)。
use Doctrine\ORM\Mapping\Driver\AttributeDriver;use Go\Bridge\Doctrine\WovenEntityClassLocator;
$configuration->setMetadataDriverImpl( new AttributeDriver(WovenEntityClassLocator::createFromDirectories([__DIR__ . '/src/Entity'])),);如果只给出普通目录,Doctrine 会直接 include 实体的源文件。这样就绕过了编译器,实体会丢掉它的 behavior(行为),而且 Doctrine 还会漏掉那些已经被自动加载器加载过的实体。WovenEntityClassLocator 从源文件中读取类名,再通过自动加载器加载每个类,而自动加载器提供的是编译后的版本。
被拦截的属性与原生惰性对象
Section titled “被拦截的属性与原生惰性对象”use Doctrine\ORM\Events;use Go\Bridge\Doctrine\MetadataLoadInterceptor;
$configuration->enableNativeLazyObjects(true);$eventManager->addEventListener(Events::loadClassMetadata, new MetadataLoadInterceptor());被拦截的属性会用原生属性钩子(property hooks)重新声明,而 Doctrine 只在启用原生惰性对象时才支持属性钩子,所以要把它打开。注册 MetadataLoadInterceptor 是可选的:当原生惰性对象处于关闭状态时,它会在加载元数据时就报告「编译后的实体含有被拦截的映射属性」,而不是等到第一个惰性代理时才失败。
Doctrine 在水合(hydrate)和 flush 时读写的是原始属性值。因此,属性上的 behavior 只会在你自己的代码访问属性时运行,Doctrine 的内部访问永远不会触发它们。
© 2026 Alexander Lisachenko
