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?
Respuesta
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.
¡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. –
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
YUI Doc es independiente del idioma. Podría ser usado. Aquí hay un video que describe su uso: http://developer.yahoo.com/yui/theater/video.php?v=woods-yuiconf2009-yuidoc
Personalmente perfer Doxygen. Es un buen sistema de documentación que admite múltiples idiomas y varios formatos de salida.
Comprobar generador de documentación API ApiGen con PHP 5.3 Apoyo
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
Actualización: a partir de marzo de 2012, phpDocumentor y DocBlox se fusionaron en phpDocumentor2 – mvriel
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.
- 1. Reemplazo para PEAR: MDB2 en PHP 5.3
- 2. ereg/eregi reemplazo para PHP 5.3
- 3. ¿Hay algún compilador/intérprete para ejecutar código para php 5.3?
- 4. ¿Existe un 'modo de compatibilidad' PHP 5.2 para PHP 5.3?
- 5. php_memcache.dll para PHP 5.3
- 6. ¿Algún tutorial sobre cómo usar phpDocumentor?
- 7. ¿Hay algún ancho completo que admita CSS Grid System?
- 8. phpDocumentor alternativa consume menos memoria
- 9. Oracle: ¿algún reemplazo para el paquete DBMS_OUTPUT?
- 10. Biblioteca de OpenID para PHP 5.3
- 11. PHP 5.3 Método mágico __invoke
- 12. Netbeans y PhpDocumentor
- 13. Reemplazo de php para safe_mode
- 14. PHP: necesita funcionalidad json_encode() 5.3 en 5.2
- 15. Uso de PHP 5.3 operador?:
- 16. accidente imagick con PHP 5.3
- 17. ¿Hay algún plan para que la JVM admita los genéricos en tiempo de ejecución?
- 18. Mensajes de desactivación de PHP 5.3 que aparecen como advertencias
- 19. ¿Cómo rompió PHP 5.3 tu aplicación?
- 20. ¿Cómo hacer que mssql funcione con PHP 5.3?
- 21. Cómo configurar memory_limit php 5.3 en Dreamhost
- 22. ¿Existe un marco para .NET que admita el concepto de "código móvil" de Erlang?
- 23. ¿Cómo instalar php-mongo en CentOS 5.3?
- 24. ¿Hay algún reemplazo innerHTML en SVG/XML?
- 25. ¿Existe algún riesgo de rendimiento para Collections.unmodifiableList?
- 26. ¿Existe algún JLabel MultiLine?
- 27. PHP Namespace 5.3 y WordPress Widget
- 28. Eliminación segura con PHP 5.3.x
- 29. Emoticon Reemplazo - PHP
- 30. Desactivar los errores obsoletos php 5.3
* Tal vez * 'Doxygen' http://stackoverflow.com/questions/2112654/php-5-3-documentor – mre
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. –