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

Question

我有一个webapp，它有多个“Controller”文件，都定义了一个名为“Controller”的类。有一个路由脚本，根据页面请求只包含正确的文件，然后实例化一个新的“Controller”对象。

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

Answer 1

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

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

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

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