phpdoc против phpxref - PullRequest
       4

phpdoc против phpxref

3 голосов
/ 06 января 2011

Есть ли у одного возможности, а у другого нет? это проблема, ни то, ни другое не обновлялось примерно через 3 года? Чего не хватает обоим?

Ответы [ 2 ]

9 голосов
/ 07 января 2011

Мне нравится думать, что они нацелены на две разные цели.

Я написал PHPXref более десяти лет назад как быстрый взлом, который позволил мне быстро и легко освоить исходный код большого проекта, не требуя большого количества инструментов (только Perl, и даже не так, если вы ') на Windows) и без необходимости удаленного веб-сервера. Часть документации была полезным побочным эффектом, но на самом деле я просто хотел достойный способ чтения через гиперссылку исходного кода в браузере.

PHPDocumentor и аналогичные инструменты значительно лучше справляются с генерацией реальной документации из различных форматов.

PHPXref может определенно использовать некоторые обновления (или переписать), но все равно должен быть полезен сегодня - вы можете загрузить его и получить вывод без конфигурации через пару минут, поэтому дешево посмотреть, подходит ли оно вашим потребностям. 1007 *

3 голосов
/ 06 января 2011

Фактическим стандартом является PHPDocumentor.

Довольно короткое сравнение phpdoc и phpxhref можно найти в этом коротком сообщении в блоге:

Поскольку оба инструмента нес тех пор он был обновлён, и он должен отражать факты.

Другой популярный документатор - doxygen .

Новый ребенок в блоке - http://github.com/theseer/phpdox

...