PHP 文档代码 - 如何使用@package和@subpackage标签


PHP Documenting Code - How to use @package and @subpackage tags?

我对在记录我的PHP代码时如何正确使用@package和@subpackage标签感到困惑。 如果它有任何相关性,这是针对 CakePHP 2.x

例如

,我将如何为位于应用程序中以下目录中的类编写包标记:

app/Model/User.php
app/Model/Behavior/Sortable.php
app/Model/Behavior/Custom/Validator.php
...

依此类推,还有更多的子目录。 我特别不确定驻留在深层子目录中的类。

/**
 * @package ??
 * @subpackage ??
 */
class ValidatorBehavior extends ModelBehavior {
}
嗯,

这是协议和惯例的问题。蛋糕用途如下:

/*
 * @package App
 * @subpackage App.Model.Behavior
 * /
...