Некоторые из новых функций PHP 5.3, включая пространства имен и анонимные функции, несовместимы с PHPDocumentor, даже с последней версией. Например, он просто вызывает ошибку, когда встречает "функцию без имени", т.е. Закрытие. Итак, есть ли другие инструменты с открытым исходным кодом, которые генерируют документацию API (желательно в HTML) из комментариев в стиле Javadoc в коде PHP 5.3?
Есть ли замена PHPDocumentor, которая поддерживает PHP 5.3?
Ответ 1
Ну, я нашел PHPDoctor, что очень хорошо работает с PHP 5.3. Хотя, мне было бы интересно, если кто-нибудь найдет что-то лучше, поэтому я не закрываю вопрос.
Ответ 2
Вы можете попробовать DocBlox; который должен быть альтернативой phpDocumentor, но с поддержкой дополнительных возможностей, полная поддержка PHP 5.3. Дополнительным преимуществом является то, что он довольно быстрый и использует относительно небольшую память.
Вы можете прочитать больше на http://www.docblox-project.org или посмотреть демонстрацию на http://demo.docblox-project.org/default
Ответ 3
Проверить ApiGen Генератор документации API с поддержкой PHP 5.3
Ответ 4
Я лично перферу Doxygen. Это хорошая система документации, которая поддерживает несколько языков и несколько форматов вывода.
Ответ 5
YUI Doc является языковым агностиком. Его можно использовать. Вот видео, описывающее его использование: http://developer.yahoo.com/yui/theater/video.php?v=woods-yuiconf2009-yuidoc
Ответ 6
Это уже упоминалось в комментарии @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), но применим.