¿phpDocumentor está muerto?


O es solo en un estado 'terminado'? He usado PHPDoc durante muchos años en todos mis proyectos PHP, pero recientemente noté que el último post en el sitio web de PHPDoc fue de 2008. Así que me pregunto si es hora de buscar otras alternativas como Doxygen. ¿Hay alguna ventaja de usar algo que no sea PHPDoc?

EDITAR: Interesante post en Dev Zone hoy cuando Matthew anunció el lanzamiento de Zend Framework 1.11.5 escribió:

"Mike van Riel se ofreció a convertir nuestra generación de documentación API a DocBlox. Ya lo habíamos estado considerando para ZF2, pero al ver la flexibilidad del sistema de plantillas y, lo que es más importante para nosotros en términos de empaquetado, la velocidad y los recursos mínimos que utiliza para generar la salida, nos vendieron. (El tiempo de generación de documentación API se redujo de 80-100 minutos a menos de 10.) Puede ver los resultados por sí mismo." http://devzone.zend.com/article/13643

Esto es por lo que estoy preocupado, si grandes proyectos como Zend Framework están abandonando PHPDoc, me parece que la inactividad de PHPDoc no pasa desapercibida. 100 minutos para 10..eso es lo que me gusta oír.

@ gms8994 buena llamada

*ACTUALIZACIÓN: Resulta que DocBlox es PHPDocumentor2 disfrazado/renombrado. http://www.docblox-project.org /

Author: Jeff Busby, 2011-04-07

4 answers

Recientemente he usado Doxygen para generar documentación para PHP.Esta es una herramienta de código abierto para documentación y soporte para otros idiomas también.Yo diría que esta es una buena herramienta y genera fácilmente documentación, así como diagramas de clases y tiene un montón de configurables features.It está disponible tanto para Windows como para UNIX/LINUX

Puede encontrar la última versión y DESCARGAR Aquí

 1
Author: samarth,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2011-08-12 13:29:07

Aunque actualmente uso doxygen, también, tengo que publicar que phpDocumentor no está muerto. En cambio, los intentos realizados por el proyecto DocBlox se unen para formar la base para PHPDocumentor2 que cuenta con un nuevo sitio web. En estos días no estoy convencido de que esté listo para la producción, pero ya se ve muy prometedor.

 2
Author: jek,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2013-07-16 06:45:30

¿Por qué arreglar algo que no está roto? PHPDoc funciona muy bien, no necesita nada más realmente. No están tratando de innovar, solo para ayudar a crear documentación. Lo cual hicieron, muy bien.

 1
Author: Robert Ross,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2011-04-07 18:02:38

Tuve varios problemas con phpDocumentor. Uno de ellos fue la exportación xml. Después de algunos intentos de arreglar el código decidí buscar una alternativa.

Lo que encontré y me gustó fue: Rarangi https://bitbucket.org/laurentj/rarangi/wiki/Home

Rarangi is a generator of documents from php source code.

Lo interesante de esto es que guarda la información en una base de datos mysql y puedes hacer tus propios informes personalizados.

 1
Author: danidacar,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2011-04-07 18:15:49