コンテンツにスキップ
ドキュメント · インテグレーション

Doctrine ORM

Doctrine ORM 3.6 以降のエンティティに対する behavior:WovenEntityClassLocator によるエンティティの検出と、ネイティブの lazy オブジェクトによるプロパティのインターセプト。

このページは英語版からの翻訳です。基準となるのは英語版のページです。 原文を読む

Doctrine ORM(3.6 以降)は、コンパイルされたエンティティをそのままマッピングします。コンパイルされたクラスは名前とすべてのマッピング属性を保ち、元のクラス本体は、Doctrine がマッピングすることのないトレイトに置かれます。設定することは 2 つです。Symfony では、バンドルがその両方を行います(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 はソースファイルからクラス名を読み取り、各クラスをオートローダーを通して読み込みます。オートローダーが提供するのはコンパイル済みのバージョンです。

インターセプトされるプロパティとネイティブの lazy オブジェクト

Section titled “インターセプトされるプロパティとネイティブの lazy オブジェクト”
use Doctrine\ORM\Events;
use Go\Bridge\Doctrine\MetadataLoadInterceptor;
$configuration->enableNativeLazyObjects(true);
$eventManager->addEventListener(Events::loadClassMetadata, new MetadataLoadInterceptor());

インターセプトされるプロパティはネイティブのプロパティフックで再宣言されますが、Doctrine がそれをサポートするのはネイティブの lazy オブジェクトを使う場合だけです。有効にしてください。MetadataLoadInterceptor の登録は任意です。ネイティブの lazy オブジェクトが無効なとき、最初の lazy プロキシで失敗する代わりに、インターセプトされるマッピング済みプロパティを持つコンパイル済みのエンティティを、メタデータの読み込み時に報告します。

Doctrine はハイドレートとフラッシュの際に、生のプロパティ値を読み書きします。そのため、プロパティに対する behavior は、Doctrine 内部のアクセスでは実行されず、あなた自身のコードによるアクセスでのみ実行されます。

© 2026 Alexander Lisachenko