Symfony Event Dispatcherを使用して、アプリケーションに基づくイベント ディスパッチ システムを実装中です。管理者は一連のモジュールを有効または有効にすることができ、中央レジストリはプラグインが関心のあるイベントを自動的に登録し、イベントのディスパッチを処理します。
現在、PHPDoc を使用してすべてのドキュメントを生成しており、ドキュメントの完全性と一貫性を保証する厳格な PHP Codesniffer 標準を採用しています。
私がやりたいことは、システムで利用可能なすべてのイベントを 1 か所にリストするドキュメントを自動的に作成することです。利用可能なイベント、これらのイベントで提供されるデータ、およびイベントで送信できる応答を簡単に見つけられるようにすることで、新しいプラグインの開発を容易にしたいと考えています。
PHPDoc を使用してこれを達成する方法はありますか? これまでのところ、私の PluginRegistry クラスを参照して、イベントを通知するメソッドに @uses タグを追加するのが最善の方法です。このようにして、少なくとも関連するメソッドを見つけることができますが、追加のドキュメント (利用可能なイベント、データ、戻りデータ、さらにはメソッド内のイベントの数) を提供しないため、理想にはほど遠いものです。