doctrine-events

Doctrine イベント（Symfony）

使用する場面

• エンティティの永続化時に副作用（タイムスタンプ、スラッグ、検索インデックス作成、通知）が必要な場合。
• EventSubscriberInterface を実装した Doctrine サブスクライバーを ORM 3 に移行する場合。
• ライフサイクルコールバック、エンティティリスナー、グローバルライフサイクルリスナーのどれを選ぶか判断する場合。

デフォルトのワークフロー

1. 最も対象範囲の狭い仕組みを選びます。コールバック（単一のエンティティ、依存関係なし）→ エンティティリスナー（単一のエンティティ、サービスが必要）→ ライフサイクルリスナー（横断的、すべてのエンティティ）。
2. 属性（#[ORM\HasLifecycleCallbacks]、#[AsEntityListener]、#[AsDoctrineListener]）を使って設定します。
3. イベント引数には、イベントごとのクラス（PostPersistEventArgs、PreUpdateEventArgs、…）を型指定します。
4. 実際の DB に対する的を絞った機能テストで、副作用が発生することを検証します。

ガードレール

• ORM 3.0 では EventSubscriberInterface を実装した Doctrine サブスクライバーが削除されています。再導入してはいけません。
• グローバルライフサイクルリスナーはすべてのエンティティで実行されるため、エンティティの型を早い段階で確認してください。
• Doctrine イベントハンドラー内で flush() を呼び出してはいけません。処理中の作業単位が破損します。
• preUpdate には制限があります。フィールドの変更には $args->setNewValue() のみを使い、関連には触れてはいけません。

段階的な情報開示

• 実行方針とリスク管理には、このファイルを使用してください。
• 3 つの仕組み、イベント引数の対応表、サブスクライバーからの移行については、reference.md を開いてください。

出力要件

• 適切な属性を設定したリスナー／コールバッククラス。
• 選択した仕組みの理由。
• 検証結果（副作用の発生を確認するテスト）。

参考資料

• reference.md