创建文件级@包的规则

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{}