Есть ли замена PHPDocumentor, которая поддерживает PHP 5.3?

Некоторые из новых функций PHP 5.3, включая пространства имен и анонимные функции, несовместимы с PHPDocumentor, даже с последней версией. Например, он просто вызывает ошибку, когда встречает "функцию без имени", т.е. Закрытие. Итак, есть ли другие инструменты с открытым исходным кодом, которые генерируют документацию API (желательно в HTML) из комментариев в стиле Javadoc в коде PHP 5.3?

6 ответов

Ну, я нашел PHPDoctor, что очень хорошо работает с PHP 5.3. Хотя, мне было бы интересно, если кто-нибудь найдет что-то лучше, поэтому я не закрываю вопрос.


Вы можете попробовать DocBlox; который должен быть альтернативой phpDocumentor, но с поддержкой дополнительных возможностей, полная поддержка PHP 5.3. Дополнительным преимуществом является то, что он довольно быстрый и использует относительно небольшую память.

Вы можете прочитать больше на http://www.docblox-project.org или посмотреть демонстрацию на http://demo.docblox-project.org/default


Проверить ApiGen Генератор документации API с поддержкой PHP 5.3


Я лично перферу Doxygen. Это хорошая система документации, которая поддерживает несколько языков и несколько форматов вывода.


YUI Doc является языковым агностиком. Его можно использовать. Вот видео, описывающее его использование: http://developer.yahoo.com/yui/theater/video.php?v=woods-yuiconf2009-yuidoc


Это уже упоминалось в комментарии @mvriel, но я отвечу ему: преемник phpDocumentor phpDocumentor 2. На своем веб-сайте:

phpDocumentor 2 создан для создания документации по API для всех функций, доступных в PHP 5.3 и выше.

phpDocumentor 2 является результатом слияния между phpDocumentor и DocBlox. Из объявление объединения на веб-сайте DocBlox:

Объявление phpDocumentor 2 - слияние старого (phpDocumentor) и нового (DocBlox).

...

Старый phpDocumentor уходит на пенсию. Некоторые усилия по исправлению ошибок могут продолжить работу с закрытием phpDocumentor 1.x, но большинство усилий в дальнейшем будет потрачено на 2.x.

Он все еще находится в альфа-стадии (начиная с 2013-04-01), но применим.

licensed under cc by-sa 3.0 with attribution.