php - 使用 phpDoc，我没有收到任何错误，但也没有结果

Question

有几个这样的文件：

/**
 * Creates a new user account.
 * Collects posted form variables, escapes them, then passes them on to Storm.
 * @package User
 */

/**
 * Do includes.
 */
include_once('../Utilities.php');
include_once('../stormLibs/user.php');

...ETC。

然后我从 phpdoc.org 运行 phpDocumentor 2。结果页面没有显示任何错误，但也没有指向任何文件、包或类的链接。

有任何想法吗？

截屏：

Answer 1

奇怪的是，您甚至没有将文件本身列为用户包的一部分。我想知道 phpdoc2 的行为是否使得一个文件只加入一个包列表，如果它还包含一些可记录的元素（类、函数、常量）。如果您的文件只是程序代码，那么其中可能没有可记录的元素，因此 phpdoc2 认为它没有任何可记录的内容。

作为一个实验，如果您的文件中确实没有可记录的元素，请尝试添加一个空的类声明，其中包含一个将其放入 User 包中的类级文档块。我很想看看这是否会使类和文件都出现在用户包列表中。