Можно ли использовать phpDocumentor для разбора тегов DocBlock?

Я хочу использовать классы phpDocumentor для разбора собственной документации PHP и работы с результатами. Я могу сделать это вручную, но я уверен, что можно использовать phpDocumentor.

Проблема в том, что я не могу найти никакой документации по этому поводу. Как именно я должен использовать классы phpDocumentor?

Спасибо за ссылку!


person yegor256    schedule 09.10.2009    source источник


Ответы (3)


Я обнаружил, что классы Zend_Reflection_* могут выполнять эту работу.

person yegor256    schedule 10.10.2009

Руководство по PHPDocumentor содержит более 700 страниц в результате запуска PHPDoc под PHPDoc. Но я смотрел на него всего пару часов несколько месяцев назад. Код представляет собой экстремальное сочетание материалов токенизатора, смешанных с регулярными выражениями, что делает, например, невозможным для PHPDoc предоставить формальный грамматик BNF для своих строк документа.

Если это важно, вам следует подумать о написании собственного анализатора PHP - по крайней мере, если вы немного разбираетесь в конструкции компилятора. PHP — довольно простой язык.

person Lothar    schedule 09.10.2009
comment
Да, я могу это написать, но я хочу использовать phpDocumentor. 700 страниц — это хорошо, но есть ли у вас более конкретные советы? - person yegor256; 09.10.2009

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

Кроме того, я почти догадываюсь, что на самом деле вы хотите начать с расширения tokenizer в PHP, которое в любом случае в основном используется внутри phpDocumentor.

person ashnazg    schedule 22.11.2009