php - phpdoc の複数のサブパッケージ

Question

ファイルを複数のサブパッケージに所属させることはできますか? 例えば：

/**
 * Name
 *
 * Desc
 *
 * @package    Core
 * @subpackage  Sub1
 * @subpackage  Sub2
 */

ありがとう！

Answer 1

名前空間の理由から、PHPDoc では許可されていないようです。PHPDocドキュメントから：

注: @subpackage タグは、実際の @package 値に含まれる要素を分類するのに役立つことを目的としています。PHP 自体では、同じスクリプト内に同じ名前の 2 つの関数を使用することは許可されていないため、PhpDocumentor では @package 内のすべての名前が一意である必要があります。 @パッケージ。それが行うことは、その @package 内の要素の視覚的なグループ化/分離のレベルを許可することです。

PHPDoc の @package は関数とクラスを疑似名前空間にする方法のようですが、 @subpackage は単に分類のためのものです。複数のサブパッケージを追加しようとしましたか? もしそうなら、結果はどうでしたか？

Answer 2

これを行うには、次を使用できます。

* @package popcap\system\cache

これにより、PHPdocs をコンパイルするときにパッケージの階層が作成されます。