为具有相同名称的多个类生成文档？

Question

我有一个网络应用程序，它有多个“控制器”文件，这些文件都定义了一个名为“控制器”的类。有一个路由脚本，仅根据页面请求包含正确的文件，然后实例化一个新的“控制器”对象。

在生成 phpDoc 自动文档时，只有第一个“Controller”类会为其生成文档，而定义“Controller”对象的所有其他文件都链接到该“Controller”的定义而不是它们自己的定义。有没有办法强制 phpDoc 为“Controller”类的每个重新定义创建唯一的文档？

Answer 1

phpDocumentor可以处理这种类名重复，但只能通过将类放在不同的“包”中来实现。

/**
 * MyClass #1
 * @package PackageOne
 */
class MyClass {}

/**
 * MyClass #2
 * @package PackageTwo
 */
class MyClass {}

这将导致两个类在同一个 phpDocumentor 执行中成功记录。