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

Question

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

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

Answer 1

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

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

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

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