# phpDocumentor Reviews **Vendor:** phpDocumentor **Category:** [Outros Softwares de Desenvolvimento](https://www.g2.com/pt/categories/other-development) **Average Rating:** 4.3/5.0 **Total Reviews:** 12 ## About phpDocumentor phpDocumentor é uma ferramenta que possibilita gerar documentação diretamente a partir do código-fonte PHP. ## phpDocumentor Reviews ### 1. Meus encontros com o PHPDocumentor **Rating:** 4.5/5.0 stars **Reviewed by:** Borislav S. | Pequena Empresa (50 ou menos emp.) **Reviewed Date:** January 01, 2021 **O que você mais gosta phpDocumentor?** - Facilidade de uso - Geração direta de documentação a partir do código e visibilidade dos comentários de origem - Conexão direta com a hierarquia de classes/namespace - Achei o recurso de geração de UML bastante útil, pois usamos ferramentas de modelagem - Configuração relativamente fácil, mesmo para projetos legados, e suporte via PHARs (legal!) - Gosto do fato de que você apoia seu código gerando sua própria documentação com o PHPDocumentor **O que você não gosta phpDocumentor?** Encontrei um pouco difícil controlar como as coisas são organizadas no resultado final. Por exemplo, a ordenação personalizada de classes/namespace seria ótima. **Que problemas é phpDocumentor E como isso está te beneficiando?** Problemas gerais: Conseguimos mostrar nossa documentação no código externamente - para nossos desenvolvedores ou contratados. Conseguimos visualizar nossa abordagem de modelagem no momento do desenvolvimento. Conseguimos mostrar/explicar a arquitetura para novos contratados. Benefícios: Ajuda na modelagem Ajuda no processo de integração Ajuda a garantir que nossos projetos estejam bem documentados ### 2. Meu projeto documentado com excelência no phpDocumentor. **Rating:** 5.0/5.0 stars **Reviewed by:** Daniel D. | Pequena Empresa (50 ou menos emp.) **Reviewed Date:** September 28, 2020 **O que você mais gosta phpDocumentor?** A facilidade que a ferramenta me propôs para gerar a documentação diretamente a partir do código-fonte do PHP, deixando meu projeto mais robusto e autoral, usando a ferramenta javadoc que posso adicionar comentários relevantes e descartar documentação repetitiva, formando uma única documentação em vários formatos, com um grande objetivo para mim de fornecer todas as ferramentas e recursos necessários para escrever uma documentação eficaz e abrangente com o menor esforço possível. Tendo um sistema de templates flexível que permite mudar sua saída de diferentes maneiras e com vários modelos, frameworks, arquiteturas plugáveis, como WordPress ou PyroCms, entre outros. **O que você não gosta phpDocumentor?** Não houve coisas negativas durante o meu uso. O software tem funcionalidades com funções que acrescentam muito à organização. **Recomendações a outras pessoas considerando phpDocumentor:** Eu recomendo porque foi fácil documentar meu projeto com as ferramentas e recursos que o phpDocumentor propôs, e deixar meu projeto de autor com as ferramentas mencionadas acima e robusto com uma biblioteca bem documentada através do javadoc. Com vários modelos de saída Html muito flexíveis e possui uma análise de código onde extrair informações em gráficos e relatórios, facilitando sua interpretação. **Que problemas é phpDocumentor E como isso está te beneficiando?** Minha empresa precisava de uma documentação de projeto onde encontrei o phpDocumentor uma ferramenta fácil de usar, onde usei o composer (instalador) dentro do meu servidor e uma boa parte do cmd fácil de usar para criar minha documentação, por trás da @tag (@author, @version) e depois começo minha programação. ### 3. Ótima documentação de código PHP **Rating:** 4.0/5.0 stars **Reviewed by:** Dolly Aswin H. | Founder, Pequena Empresa (50 ou menos emp.) **Reviewed Date:** January 20, 2021 **O que você mais gosta phpDocumentor?** Eu comecei a usar o phpDocumentor desde 2010. E essa ferramenta é muito útil para documentar minha biblioteca PHP. **O que você não gosta phpDocumentor?** Para mim, não houve desvantagens no phpDocumentor. Mas só é necessário disciplina para executá-lo e atualizar a documentação do código. **Que problemas é phpDocumentor E como isso está te beneficiando?** Na minha equipe, desenvolvemos nossa própria biblioteca. E a documentação do código foi muito útil para entender a estrutura do código, classe e método. Qual é o propósito do método e qual é o resultado esperado. E quando um novo desenvolvedor se junta, ele pode aprender com essa documentação. ### 4. Php documentor é uma ótima ferramenta **Rating:** 4.0/5.0 stars **Reviewed by:** Usuário Verificado em Tecnologia da Informação e Serviços | Pequena Empresa (50 ou menos emp.) **Reviewed Date:** December 03, 2020 **O que você mais gosta phpDocumentor?** Isso é útil porque podemos navegá-los mais rapidamente do que arquivos de código e obter uma documentação muito boa que pode ser distribuída a todos os desenvolvedores da equipe, prestadores de serviços terceirizados ou novas pessoas em sua equipe sem muito trabalho adicional. **O que você não gosta phpDocumentor?** Está quase desatualizado.. Não há mais desenvolvimento ou aprimoramento significativo **Que problemas é phpDocumentor E como isso está te beneficiando?** É ótimo criar documentos de API, ajuda o IDE, pois ele poderá fornecer mais detalhes sobre que tipo de parâmetros e métodos suas classes oferecem e precisam. ### 5. Melhor documentação para PHP **Rating:** 4.0/5.0 stars **Reviewed by:** Sawan N. | Technical Analyst, Pequena Empresa (50 ou menos emp.) **Reviewed Date:** December 01, 2020 **O que você mais gosta phpDocumentor?** A facilidade da interface do usuário e o conteúdo geral são muito informativos. **O que você não gosta phpDocumentor?** Junto com os tópicos, deveria haver mais exemplos. **Recomendações a outras pessoas considerando phpDocumentor:** O conteúdo é realmente bom, deve-se experimentar pelo menos uma vez. **Que problemas é phpDocumentor E como isso está te beneficiando?** Isso me ajuda a melhorar minhas habilidades principais em PHP. ### 6. PHPDoc vs Swagger **Rating:** 5.0/5.0 stars **Reviewed by:** Mohsen A. | Senior Backend Developer / Architect / Lead , Pequena Empresa (50 ou menos emp.) **Reviewed Date:** November 27, 2019 **O que você mais gosta phpDocumentor?** Fácil sintaxe Suportado por IDEs Embutido no código **O que você não gosta phpDocumentor?** Sem suporte para parâmetros com arrays tipados aninhados nem para arrays de chave-valor. **Recomendações a outras pessoas considerando phpDocumentor:** Eu tive experiência com ambos Swagger e PHPDoc. Swagger é complexo e demorado para escrever documentos. PHPDoc fornece apenas uma maneira simples de escrever documentos no meio do código. Se você está escolhendo entre os dois, eu provavelmente sugeriria PHPDoc. A única característica ausente no PHPDoc é a falta de suporte para arrays tipados aninhados, bem como arrays de chave-valor. **Que problemas é phpDocumentor E como isso está te beneficiando?** Os documentadores de código-fonte resolvem dois problemas principais: "Entrega de código-fonte" e "Referenciamento de API". As duas ferramentas de documentação bem conhecidas para PHP são PHPDoc e Swagger. Swagger fornece uma solução mais complexa para documentar o código PHP. Você pode embutir a sintaxe no meio do código ou simplesmente criar arquivos separados para a documentação. As classes devem ser mapeadas independentemente, o que torna mais demorado escrever um documento. Mesmo a sintaxe embutida é difícil de escrever. Por outro lado, a única coisa que você precisa fazer com o PHPDoc é escrever seu documento acima de suas definições. A sintaxe é limpa, tem suporte nativo por IDEs populares, incluindo PHPStorm, Netbeans, etc., e tudo se move de forma super fácil. ### 7. Eu uso o PHPDocumentor para gerar comentários. **Rating:** 4.5/5.0 stars **Reviewed by:** Usuário Verificado em Jogos de Computador | Pequena Empresa (50 ou menos emp.) **Reviewed Date:** July 23, 2020 **O que você mais gosta phpDocumentor?** Automatizando a geração de comentários. Os comentários têm a estrutura correta. **O que você não gosta phpDocumentor?** Os comentários em casos muito raros precisam de correção. **Recomendações a outras pessoas considerando phpDocumentor:** Eles devem tentar e depois tomar uma decisão. **Que problemas é phpDocumentor E como isso está te beneficiando?** Eu uso o phpDocumentor para gerar comentários. ### 8. Excelente ferramenta para auto-documentação em códigos PhP gerados. **Rating:** 4.5/5.0 stars **Reviewed by:** Margareth S. | Computer Technical Specialist, Empresa (> 1000 emp.) **Reviewed Date:** August 21, 2019 **O que você mais gosta phpDocumentor?** Eu realmente gosto de sua funcionalidade em si, é uma ferramenta que nos permite auto-documentar o código que escrevemos na linguagem PHP e isso é feito automaticamente usando o código-fonte. Eu realmente gosto que, ao fazer uso de uma ferramenta como esta para todo o código que programamos, nos permite ter como uma espécie de modelo de documentação que nossos códigos têm e poder entender mais facilmente o que é programado e quais funções são as que se encontram em cada seção, eu realmente gosto que usar esta ferramenta nos permite continuar facilmente o código deixado por algum outro programador ou que algum colaborador continue facilmente o código criado por nós, já que nos permite ter uma boa documentação. Eu também gosto muito que nos permite migrar todo o código para um arquivo HTML com um grande grau de detalhe de tudo, desde comentários até funções, variáveis, entre outras coisas. **O que você não gosta phpDocumentor?** Basicamente, o único ponto negativo é a pequena comunidade que possui e que talvez ainda não seja uma ferramenta que recebeu o reconhecimento que merece, mas a verdade é que é uma ferramenta que força o programador a ter uma boa prática de codificação. **Recomendações a outras pessoas considerando phpDocumentor:** Eu realmente não vejo nenhuma razão para não recomendar esta ferramenta, acho que é excelente e que a verdade é uma ferramenta que eventualmente nos trará muitos benefícios, tanto ao atualizar um aplicativo quanto ao adicionar novas funções a algum sistema. **Que problemas é phpDocumentor E como isso está te beneficiando?** É uma ferramenta que tem sido muito útil para mim, tem me feito melhorar as boas práticas de programação, obrigando-me a preencher os campos de documentação necessários para entender facilmente o código, e também tem sido super útil no campo de trabalho ao contratar um novo programador ou ao precisar da colaboração de algum terceiro. ### 9. Php documentor é uma ótima ferramenta para gerar documentação a partir do código-fonte. **Rating:** 4.0/5.0 stars **Reviewed by:** Wolfred M. | Full Stack Developer, Pequena Empresa (50 ou menos emp.) **Reviewed Date:** May 15, 2019 **O que você mais gosta phpDocumentor?** - Php documentor tem múltiplos templates para que a documentação fique mais agradável à visualização do usuário. - Php documentor é capaz de interpretar as informações para criar gráficos e relatórios. - Php documentor tem uma seção importante para relatar todos os `TODO` que estão colocados no código. - Php documentor cria a wiki completa para todas as funções; até mesmo o construtor e constantes para cada classe. **O que você não gosta phpDocumentor?** - Apesar de ter múltiplos modelos, parece que os modelos são muito antigos para as ferramentas HTML atuais. - A instalação não é fácil de fazer. **Recomendações a outras pessoas considerando phpDocumentor:** Os novos modelos poderiam ser trabalhados com as novas ferramentas HTML 5. **Que problemas é phpDocumentor E como isso está te beneficiando?** Minha empresa precisa ter a documentação muito clara para que os desenvolvedores entendam melhor o código, especialmente quando um novo contratado está na empresa. ### 10. phpDocumentor **Rating:** 5.0/5.0 stars **Reviewed by:** Mirian M. | OpenNebula, Médio Porte (51-1000 emp.) **Reviewed Date:** March 02, 2019 **O que você mais gosta phpDocumentor?** É o máximo, já que, como programador e para tempos de execução, é difícil comentar o código, esta ferramenta faz a análise do código-fonte e gera um arquivo seguindo os padrões de programação, o que ajuda a entender os próprios códigos e os de outros programadores. **O que você não gosta phpDocumentor?** Não funciona, mas se você seguir certos parâmetros ou padrões da programação, pode apresentar falhas. **Recomendações a outras pessoas considerando phpDocumentor:** it. recomendação. **Que problemas é phpDocumentor E como isso está te beneficiando?** Documentação completa do sistema feita na linguagem PHP ## phpDocumentor Discussions - [Para que é usado o phpDocumentor?](https://www.g2.com/pt/discussions/what-is-phpdocumentor-used-for) - [sdgsfgsfdgsdfgsdfgdsfdsf](https://www.g2.com/pt/discussions/34466-sdgsfgsfdgsdfgsdfgdsfdsf) - 1 upvote ## Top phpDocumentor Alternatives - [Okta](https://www.g2.com/pt/products/okta/reviews) - 4.5/5.0 (1,159 reviews) - [Termius](https://www.g2.com/pt/products/termius/reviews) - 4.8/5.0 (248 reviews) - [SAP Fiori](https://www.g2.com/pt/products/sap-fiori/reviews) - 4.3/5.0 (124 reviews)