# phpDocumentor Reviews **Vendor:** phpDocumentor **Category:** [Otro software de desarrollo](https://www.g2.com/es/categories/other-development) **Average Rating:** 4.3/5.0 **Total Reviews:** 12 ## About phpDocumentor phpDocumentor es una herramienta que hace posible generar documentación directamente desde el código fuente de PHP. ## phpDocumentor Reviews ### 1. Mis encuentros con PHPDocumentor **Rating:** 4.5/5.0 stars **Reviewed by:** Borislav S. | Pequeña Empresa (50 o menos empleados) **Reviewed Date:** January 01, 2021 **¿Qué es lo que más te gusta de phpDocumentor?** - Facilidad de uso - Generación directa de documentación a partir del código y visibilidad de comentarios de origen - Conexión directa con la jerarquía de clases/espacios de nombres - He encontrado que la función de generación de UML es bastante útil ya que usamos herramientas de modelado - Configuración relativamente fácil incluso para proyectos heredados y soporte inmediato a través de PHARs (¡genial!) - Me gusta el hecho de que respaldes tu código generando tus propios documentos con PHPDocumentor **¿Qué es lo que no te gusta de phpDocumentor?** He encontrado un poco difícil controlar cómo se organizan las cosas en el resultado final. Por ejemplo, el orden personalizado de clases/espacios de nombres sería genial. **¿Qué problemas resuelve phpDocumentor ¿Y cómo te beneficia eso?** Problemas en general: Hemos podido mostrar nuestra documentación en el código externamente, a nuestros desarrolladores o contratistas. Hemos podido previsualizar nuestro enfoque de modelado en el momento del desarrollo. Hemos podido mostrar/explicar la arquitectura a los nuevos empleados. Beneficios: Ayuda con el modelado Ayuda con el proceso de incorporación Ayuda a asegurar que nuestros proyectos estén bien documentados ### 2. Mi proyecto documentado con excelencia en phpDocumentor. **Rating:** 5.0/5.0 stars **Reviewed by:** Daniel D. | Pequeña Empresa (50 o menos empleados) **Reviewed Date:** September 28, 2020 **¿Qué es lo que más te gusta de phpDocumentor?** La facilidad que la herramienta me propuso para generar la documentación directamente desde el código fuente de PHP, dejando mi proyecto más robusto y autoral, utilizando la herramienta javadoc con la que puedo añadir comentarios relevantes y descartar documentación repetitiva, formando una única documentación en varios formatos, con un gran objetivo para mí de proporcionar todas las herramientas y recursos necesarios para escribir documentación efectiva y completa con el menor esfuerzo posible. Tener un sistema de plantillas flexible que permite cambiar la salida de diferentes maneras y con varios modelos, marcos, arquitecturas enchufables, como WordPress o PyroCms, entre otros. **¿Qué es lo que no te gusta de phpDocumentor?** No hubo cosas negativas durante mi uso. El software tiene funcionalidades con funciones que aportan mucho a la organización. **Recomendaciones a otros que estén considerando phpDocumentor:** Lo recomiendo porque fue fácil documentar mi proyecto con las herramientas y recursos que propuso phpDocumentor, y dejar mi proyecto de autor con las herramientas mencionadas anteriormente y robusto con una biblioteca bien documentada a través de javadoc. Con varios modelos de salida Html muy flexibles y tiene un análisis de código donde extraer información en gráficos e informes, facilitando su interpretación. **¿Qué problemas resuelve phpDocumentor ¿Y cómo te beneficia eso?** Mi empresa necesitaba una documentación de proyecto donde encontré phpDocumentor, una herramienta fácil de usar, donde utilicé el composer (instalador) dentro de mi servidor y una buena parte del cmd fácil de usar para crear mi documentación, detrás de la @tag (@autor, @versión) y después comienzo mi programación. ### 3. Gran documentación de código PHP **Rating:** 4.0/5.0 stars **Reviewed by:** Dolly Aswin H. | Founder, Pequeña Empresa (50 o menos empleados) **Reviewed Date:** January 20, 2021 **¿Qué es lo que más te gusta de phpDocumentor?** Comencé a usar phpDocumentor desde 2010. Y esta herramienta es muy útil para documentar mi biblioteca PHP. **¿Qué es lo que no te gusta de phpDocumentor?** Para mí, no hubo inconvenientes con phpDocumentor. Pero solo se necesita disciplina para ejecutarlo y actualizar la documentación del código. **¿Qué problemas resuelve phpDocumentor ¿Y cómo te beneficia eso?** En mi equipo, desarrollamos nuestra propia biblioteca. Y la documentación del código fue muy útil para entender la estructura del código, la clase y el método. Cuál es el propósito del método y cuál es el resultado esperado. Y cuando un nuevo desarrollador se une, puede aprender de esta documentación. ### 4. Php documentor Gran herramienta **Rating:** 4.0/5.0 stars **Reviewed by:** Usuario verificado en Tecnología de la información y servicios | Pequeña Empresa (50 o menos empleados) **Reviewed Date:** December 03, 2020 **¿Qué es lo que más te gusta de phpDocumentor?** Esto es útil porque podemos navegar por ellos más rápido que por los archivos de código, y obtener una documentación muy buena que se puede entregar a todos los desarrolladores del equipo, proveedores de servicios externos o nuevas personas en tu equipo sin mucho trabajo adicional. **¿Qué es lo que no te gusta de phpDocumentor?** Está casi obsoleto.. Ya no hay un desarrollo o mejora significativa **¿Qué problemas resuelve phpDocumentor ¿Y cómo te beneficia eso?** Es genial crear documentos de API, ayuda al IDE ya que podrá darte más detalles sobre qué tipo de parámetros y métodos proporcionan y necesitan tus clases. ### 5. Mejor documentación para PHP **Rating:** 4.0/5.0 stars **Reviewed by:** Sawan N. | Technical Analyst, Pequeña Empresa (50 o menos empleados) **Reviewed Date:** December 01, 2020 **¿Qué es lo que más te gusta de phpDocumentor?** La facilidad de la interfaz de usuario y el contenido en general es muy informativo. **¿Qué es lo que no te gusta de phpDocumentor?** Junto con los temas, debería haber más ejemplos. **Recomendaciones a otros que estén considerando phpDocumentor:** El contenido es realmente bueno, uno debería probarlo al menos una vez. **¿Qué problemas resuelve phpDocumentor ¿Y cómo te beneficia eso?** Me ayuda a mejorar mis habilidades fundamentales en PHP. ### 6. PHPDoc frente a Swagger **Rating:** 5.0/5.0 stars **Reviewed by:** Mohsen A. | Senior Backend Developer / Architect / Lead , Pequeña Empresa (50 o menos empleados) **Reviewed Date:** November 27, 2019 **¿Qué es lo que más te gusta de phpDocumentor?** Sintaxis fácil Compatible con IDEs Incorporado en el código **¿Qué es lo que no te gusta de phpDocumentor?** No hay soporte para parámetros con matrices tipadas anidadas ni para matrices de clave-valor. **Recomendaciones a otros que estén considerando phpDocumentor:** Tuve experiencia con Swagger y PHPDoc. Swagger es complejo y requiere mucho tiempo para escribir documentos. PHPDoc proporciona solo una forma simple de escribir documentos en medio del código. Si estás eligiendo entre los dos, probablemente sugeriría PHPDoc. La única característica que falta en PHPDoc es el soporte para arreglos tipados anidados, así como arreglos de clave-valor. **¿Qué problemas resuelve phpDocumentor ¿Y cómo te beneficia eso?** Los documentadores de código fuente resuelven dos problemas principales: "Entrega de código fuente" y "Referencia de API". Las dos herramientas de documentación bien conocidas para PHP son PHPDoc y Swagger. Swagger proporciona una solución más compleja para documentar el código PHP. Puedes incrustar la sintaxis en medio del código o simplemente crear archivos separados para la documentación. Las clases deben mapearse de manera independiente, lo que hace que sea más laborioso escribir un documento. Incluso la sintaxis incrustada es difícil de escribir. Por otro lado, lo único que necesitas hacer con PHPDoc es escribir tu documento sobre tus definiciones. La sintaxis es limpia, tiene soporte nativo por IDEs populares, incluyendo PHPStorm, Netbeans, etc., y en conjunto todo se mueve con mucha facilidad. ### 7. Utilizo PHPDocumentor para generar comentarios. **Rating:** 4.5/5.0 stars **Reviewed by:** Usuario verificado en Videojuegos | Pequeña Empresa (50 o menos empleados) **Reviewed Date:** July 23, 2020 **¿Qué es lo que más te gusta de phpDocumentor?** Generador automático de comentarios. Los comentarios tienen la estructura correcta. **¿Qué es lo que no te gusta de phpDocumentor?** Los comentarios en casos muy raros necesitan corrección. **Recomendaciones a otros que estén considerando phpDocumentor:** Deberían intentar y después tomar una decisión. **¿Qué problemas resuelve phpDocumentor ¿Y cómo te beneficia eso?** Utilizo phpDocumentor para generar comentarios. ### 8. Excelente herramienta para la auto-documentación en códigos PhP generados. **Rating:** 4.5/5.0 stars **Reviewed by:** Margareth S. | Computer Technical Specialist, Empresa (> 1000 empleados) **Reviewed Date:** August 21, 2019 **¿Qué es lo que más te gusta de phpDocumentor?** Realmente me gusta su funcionalidad en sí misma, es una herramienta que nos permite auto-documentar el código que hemos escrito en el lenguaje PHP y esto se hace automáticamente utilizando el código fuente. Me gusta mucho que al hacer uso de una herramienta como esta para todo el código que programamos, nos permite tener una especie de plantilla de documentación que tienen nuestros códigos y poder entender más fácilmente lo que está programado y qué funciones son las que se encuentran en cada sección. Me gusta mucho que usar esta herramienta nos permite continuar fácilmente el código dejado por algún otro programador o que algún colaborador continúe fácilmente el código creado por nosotros ya que nos permite tener una buena documentación. También me gusta mucho que nos permite migrar todo el código a un archivo HTML con un gran grado de detalle de todo, desde comentarios hasta funciones, variables, entre otras cosas. **¿Qué es lo que no te gusta de phpDocumentor?** Básicamente, el único aspecto negativo es la pequeña comunidad que tiene y que quizás no es una herramienta que aún ha recibido el reconocimiento que merece, pero la verdad es que es una herramienta que obliga al programador a tener una buena práctica de codificación. **Recomendaciones a otros que estén considerando phpDocumentor:** Realmente no veo ninguna razón para no recomendar esta herramienta, creo que es excelente y que la verdad es una herramienta que eventualmente nos traerá muchos beneficios, tanto al actualizar una aplicación como al agregar nuevas funciones a algún sistema. **¿Qué problemas resuelve phpDocumentor ¿Y cómo te beneficia eso?** Es una herramienta que ha sido muy útil para mí, me ha hecho mejorar las buenas prácticas de programación, obligándome a completar los campos de documentación necesarios para entender fácilmente el código, y también ha sido súper útil en el ámbito laboral al contratar a un nuevo programador o al necesitar la colaboración de algún tercero. ### 9. Php documentor es una gran herramienta para generar documentación a partir del código fuente. **Rating:** 4.0/5.0 stars **Reviewed by:** Wolfred M. | Full Stack Developer, Pequeña Empresa (50 o menos empleados) **Reviewed Date:** May 15, 2019 **¿Qué es lo que más te gusta de phpDocumentor?** - Php documentor tiene múltiples plantillas para que la documentación sea más agradable a la vista del usuario. - Php documentor es capaz de interpretar la información para crear gráficos e informes. - Php documentor tiene una sección importante para reportar todos los `TODO` que se encuentran en el código. - Php documentor crea toda la wiki para todas las funciones; incluso el constructor y las constantes para cada clase. **¿Qué es lo que no te gusta de phpDocumentor?** - A pesar de que tiene múltiples plantillas, parece que las plantillas son demasiado antiguas para las herramientas HTML actuales. - La instalación no es fácil de realizar. **Recomendaciones a otros que estén considerando phpDocumentor:** Los nuevos modelos podrían trabajarse con las nuevas herramientas de HTML 5. **¿Qué problemas resuelve phpDocumentor ¿Y cómo te beneficia eso?** Mi empresa necesita tener muy clara la documentación para que los desarrolladores entiendan mejor el código, en especial, cuando hay una nueva contratación en la empresa. ### 10. phpDocumentor **Rating:** 5.0/5.0 stars **Reviewed by:** Mirian M. | OpenNebula, Mediana Empresa (51-1000 empleados) **Reviewed Date:** March 02, 2019 **¿Qué es lo que más te gusta de phpDocumentor?** Es el máximo ya que como programador y por los tiempos de ejecución es difícil comentar el código, esta herramienta realiza el análisis del código fuente y genera un archivo siguiendo los estándares de programación, lo que ayuda a entender los propios códigos y los de otros programadores. **¿Qué es lo que no te gusta de phpDocumentor?** No funciona, pero si sigues ciertos parámetros o estándares de la programación, puede darte fallos. **Recomendaciones a otros que estén considerando phpDocumentor:** úsalo. recomendado. **¿Qué problemas resuelve phpDocumentor ¿Y cómo te beneficia eso?** Documentación completa del sistema realizada en el lenguaje PHP. ## phpDocumentor Discussions - [¿Para qué se utiliza phpDocumentor?](https://www.g2.com/es/discussions/what-is-phpdocumentor-used-for) - [sdgsfgsfdgsdfgsdfgdsfdsf](https://www.g2.com/es/discussions/34466-sdgsfgsfdgsdfgsdfgdsfdsf) - 1 upvote ## Top phpDocumentor Alternatives - [Okta](https://www.g2.com/es/products/okta/reviews) - 4.5/5.0 (1,159 reviews) - [Termius](https://www.g2.com/es/products/termius/reviews) - 4.8/5.0 (248 reviews) - [SAP Fiori](https://www.g2.com/es/products/sap-fiori/reviews) - 4.3/5.0 (124 reviews)