创建文件级别@package的规则

Question

我的代码如下所示：

/**
 * @package Test
 */
require_once('foo.php');

/**
 * Main class
 */
class Test{
}

/**
 * Generic exception
 */
class Test_Excepcion extends Exception{
}

我希望第一个docblock是文件级块，但是ApiGen似乎将它链接到require语句，我的类显示在“None”命名空间中。如果我这样做，它会得到修复。这样：

/**
 * @package Test
 */
//
require_once('foo.php');

这是预期的行为吗？在文件级别块之后是否需要添加虚假注释？准确的规则是什么？

Answer 1

@package标记不一定是文件级块。您可以为文件中的每个类指定@package标记。像这样：

/**
 * Main class
 * @package Test
 */
class Test{}