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

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

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


phpdoc
person MidnightLightning    schedule 16.01.2012    source источник

Ответы (1)


arrow_upward
0
arrow_downward

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

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

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

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

person ashnazg    schedule 17.01.2012