2010-02-14 21 views
22

Algunas de las nuevas características de PHP 5.3, incluidos los espacios de nombres y las funciones anónimas, no son compatibles con PHPDocumentor, incluso con la última versión. Por ejemplo, solo genera un error cuando encuentra "una función sin nombre", es decir, un cierre. Entonces, ¿hay alguna otra herramienta de código abierto que genere documentación API (preferiblemente en HTML) a partir de comentarios estilo Javadoc en código PHP 5.3?¿Existe algún reemplazo para PHPDocumentor que admita PHP 5.3?

+0

* Tal vez * 'Doxygen' http://stackoverflow.com/questions/2112654/php-5-3-documentor – mre

+2

Doxygen logra terminar de crear la documentación, pero el resultado sigue sin sentido. No parece analizar correctamente las declaraciones del espacio de nombres, ni distingue las declaraciones de cierre de las llamadas a funciones. –

Respuesta

11

Bueno, he encontrado PHPDoctor, que funciona bastante bien con PHP 5.3. Aunque, seguiría interesado si alguien encuentra algo mejor, así que no estoy cerrando la pregunta.

+0

¡Lo único que lamento es que solo tengo un voto para dar! He estado buscando y buscando algo que realmente sea compatible con PHP5.3 y ahora lo he encontrado. –

+0

Harto de PHPDocumentor en PHP5.3, tuve instalado PHPDoctor, configuré y generé la documentación completa 10 minutos después de saber que existía. Bonito. – Eli

3

Personalmente perfer Doxygen. Es un buen sistema de documentación que admite múltiples idiomas y varios formatos de salida.

6

Comprobar generador de documentación API ApiGen con PHP 5.3 Apoyo

14

Usted podría intentar DocBlox; que pretende ser una alternativa para phpDocumentor pero con soporte para características adicionales de las cuales el soporte completo de PHP 5.3 es uno. Un beneficio adicional es que es bastante rápido y usa relativamente poca memoria.

Puede leer más en http://www.docblox-project.org o vea una demostración en http://demo.docblox-project.org/default

+3

Actualización: a partir de marzo de 2012, phpDocumentor y DocBlox se fusionaron en phpDocumentor2 – mvriel

0

Esto ya fue mencionado en un comentario de @mvriel, pero me va a hacer que una respuesta: el sucesor de phpDocumentor es phpDocumentor 2. Desde su sitio web:

phpDocumentor 2 está construido para generar documentación API para todas las funciones disponibles en PHP 5.3 y superior.

phpDocumentor 2 es el resultado de la fusión entre phpDocumentor y DocBlox. Desde el merge announcement en la página web de DocBlox:

anunciar phpDocumentor 2 - la fusión de la antigua (phpDocumentor) y el nuevo (DocBlox).

...

Antiguo phpDocumentor se retira. Algún esfuerzo de corrección de errores puede continuar para llevar a phpDocumentor 1.x a su fin, pero la mayor parte del esfuerzo futuro se gastará en 2.x.

Todavía está en fase alfa (desde 2013-04-01), pero se puede usar.

Cuestiones relacionadas