PhpDocumentor умер?

Или это только в "законченном" состоянии? Я использовал PHPDoc в течение многих лет во всех своих PHP-проектах, но недавно я заметил, что последний пост на веб-сайте PHPDoc был датирован 2008 годом. Поэтому мне интересно, не пора ли рассмотреть другие альтернативы, такие как Doxygen. Есть ли какие-то преимущества в использовании чего-то другого, кроме PHPDoc?

РЕДАКТИРОВАТЬ: Интересный пост на Dev Zone сегодня, когда Мэтью объявил о выпуске Zend Framework 1.11.5, он написал:

«Майк ван Риэль предложил преобразовать наше поколение документации API в DocBlox. Мы уже рассматривали его для ZF2, но, увидев гибкость системы шаблонов и, что более важно для нас с точки зрения упаковки, скорости и минимальных ресурсов он использует для создания выходных данных, мы были проданы. (Время создания документации API было сокращено с 80-100 минут до менее чем 10.) Вы можете просмотреть результаты для себя." http://devzone.zend.com/article/13643

Вот почему я обеспокоен тем, что если крупные проекты, такие как Zend Framework, отказываются от phpDoc, мне кажется, что бездействие phpDoc не останется незамеченным. Со 100 минут до 10... вот что мне нравится слышать.

@gms8994 хороший звонок

* ОБНОВЛЕНИЕ: Получается, что DocBlox — это замаскированный/переименованный PHPDocumentor2. http://www.docblox-project.org/


person Jeff Busby    schedule 07.04.2011    source источник
comment
Я бы тоже очень хотел знать ответ на этот вопрос. Давно не было активности в проекте. Или в противном случае я действительно хотел бы знать о хорошей альтернативе.   -  person GordonM    schedule 07.04.2011
comment
Попробуйте github.com/theseer/phpdox для разнообразия.   -  person Gordon    schedule 07.04.2011
comment
Другой альтернативой является DocBlox.   -  person Glen Solsberry    schedule 07.04.2011
comment
Я голосую за то, чтобы закрыть этот вопрос как не по теме, потому что он основан на времени. Когда-то разработка PhpDoc замедлялась, теперь она жива и здорова, а некоторые альтернативы испытывают трудности. Через пару лет все может быть совсем по-другому. В своем нынешнем состоянии он просто сбивает с толку и/или вводит в заблуждение.   -  person Potherca    schedule 19.02.2016


Ответы (5)


Недавно я использовал Doxygen для создания документации для PHP. Это инструмент с открытым исходным кодом для документации и поддержки других языков. Я бы сказал, что это хороший инструмент, и он легко создает документацию, а также диаграммы классов. и имеют множество настраиваемых функций. Он доступен как для Windows, так и для UNIX/LINUX.

Можно найти последнюю версию и СКАЧАТЬ здесь

person samarth    schedule 12.08.2011

Хотя в настоящее время я также использую doxygen, я должен опубликовать, что PHPDocumentor не умер. Вместо этого попытки проекта DocBlox объединяются, чтобы сформировать основу для PHPDocumentor2 с новым веб-сайтом. В эти дни я не уверен, что он готов к производству, но он уже выглядит действительно многообещающе.

person jek    schedule 16.07.2013

Зачем чинить то, что не сломано? PHPDoc отлично работает, больше ничего не нужно. Они не пытаются вводить новшества, просто помогают создавать документацию. Что они и сделали, очень хорошо.

person Robert Ross    schedule 07.04.2011
comment
Да, я понимаю, что если он не сломан, не чините его, и я определенно не согласен с этим. Моя проблема, и это не немедленная проблема, заключается в том, что, если что-то сломается в phpDoc с новой версией PHP (например, php6) или с новой функцией, которая не поддерживается в phpDoc, есть ли кто-то в сообществе phpDoc, который поднимется и быстро исправить? И вторая часть моего вопроса, я объясню немного лучше: есть ли обязательные функции, которые есть у Doxygen или phpDox (или любой другой программы документации), которые могут стать убедительным аргументом для переключения? - person Jeff Busby; 07.04.2011
comment
Я думаю, что достаточное количество проектов с открытым исходным кодом используют phpDoc, чтобы проект или сами пользователи выступили и помогли исправить его. Например, CakePHP, огромный PHP-фреймворк, который ежедневно совершенствуется, активно использует phpDoc. Мой работодатель активно использует PhpDoc, этот список можно продолжить. Я знаю, что мы пытаемся внести свой вклад в CakePHP, и исправление PhpDoc само по себе будет вкладом. - person Robert Ross; 07.04.2011
comment
Ну когда выйдет PHP 6, тогда и возродят. До тех пор, в чем проблема? - person Andrew; 07.04.2011
comment
Хотя будут ли? Кажется, что кто-то будет, но вы не можете сказать наверняка. Во всяком случае, я бы хотел, чтобы кто-то работал над этим сейчас, хотя бы просто для того, чтобы попытаться уменьшить его объем памяти. - person Jeff Busby; 07.04.2011
comment
Согласно Википедии, PhpDoc прекратил разработку в 2010 году и официально мертв. Кроме того, что касается «если это не сломалось, не чини это», проблема в том, что PHP не стоит на месте. PhpDoc, вероятно, все еще хорош для кодовых баз 5.2, но 5.3 вводит пространства имен, позднее статическое связывание, всевозможные дополнения к SPL и так далее. Пространства имен, вероятно, задушили бы PhpDoc, поскольку он их не понимает. - person GordonM; 17.11.2011

У меня было несколько проблем с phpDocumentor. Одним из них был экспорт xml. После нескольких попыток исправить код я решил поискать альтернативу.

Что мне понравилось, так это: Rarangi https://bitbucket.org/laurentj/rarangi/wiki/Home

Rarangi is a generator of documents from php source code.

Интересно то, что он сохраняет информацию в базе данных mysql, и вы можете создавать свои собственные отчеты.

person johnlemon    schedule 07.04.2011
comment
Спасибо за предложение @danip, как и два упомянутых выше, похоже, что это хорошее начало, но опять же, оно молодое и не похоже, что сообщество еще поддерживает его. Я тоже буду следить за этим. - person Jeff Busby; 07.04.2011

phpDocumentor v3 (с надлежащей поддержкой PHP 7) в настоящее время является альфа-версией, приближающейся к стабильной версии. Проблема в том, что над этим работает не так много людей, поэтому разработка идет медленно.

Я протестировал последнюю альфа-версию на одном из моих проектов Symfony, и она работает нормально, хотя в ней отсутствуют некоторые функции и есть пара ошибок. Обо всем, конечно же, сообщили.

https://github.com/phpDocumentor/phpDocumentor/releases

Обновление: phpDocumentor v3 только что стал бета-версией. Проверяйте выпуски.

person crimson_king    schedule 29.01.2020