Создать документацию для нескольких классов с одинаковым именем?

Question

У меня есть веб-приложение, в котором есть несколько файлов «Controller», которые все определяют класс «Controller». Существует сценарий маршрутизации, который включает только соответствующий файл в зависимости от запроса страницы, а затем создает новый объект «Контроллер».

При создании автоматической документации phpDoc только первый класс «Controller» получает документацию, сгенерированную для него, и все другие файлы, которые определяют объект «Controller», ссылаются на это одно определение «Controller», а не на свое собственное. Есть ли способ заставить phpDoc создавать уникальную документацию для каждого переопределения класса «Контроллер»?

Answer 1

phpDocumentor может обрабатывать этот тип дублирования имен классов, но только помещая классы в разные "пакеты".

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

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

Это приведет к успешному документированию обоих классов в одном и том же выполнении phpDocumentor.