# phpDocumentor Reviews **Vendor:** phpDocumentor **Category:** [Autres logiciels de développement](https://www.g2.com/fr/categories/other-development) **Average Rating:** 4.3/5.0 **Total Reviews:** 12 ## About phpDocumentor phpDocumentor est un outil qui permet de générer de la documentation directement à partir du code source PHP. ## phpDocumentor Reviews ### 1. Mes rencontres avec PHPDocumentor **Rating:** 4.5/5.0 stars **Reviewed by:** Borislav S. | Petite entreprise (50 employés ou moins) **Reviewed Date:** January 01, 2021 **Qu'aimez-vous le plus à propos de phpDocumentor?** - Facilité d'utilisation - Génération directe de documentation à partir du code et visibilité des commentaires source - Connexion directe à la hiérarchie des classes/espaces de noms - J'ai trouvé la fonctionnalité de génération UML assez utile car nous utilisons des outils de modélisation - Configuration relativement facile même pour les projets hérités et prise en charge via des PHARs (sympa !) - J'aime le fait que vous souteniez votre code en générant vos propres documents avec PHPDocumentor **Que n’aimez-vous pas à propos de phpDocumentor?** J'ai trouvé un peu difficile de contrôler comment les choses sont organisées dans le résultat final. Par exemple, un classement personnalisé des classes/espaces de noms serait formidable. **Quels sont les problèmes que phpDocumentor résout, et en quoi cela vous est-il bénéfique?** Problèmes globaux : Nous avons pu montrer notre documentation dans le code à l'extérieur - à nos développeurs ou sous-traitants. Nous avons pu prévisualiser notre approche de modélisation au moment du développement. Nous avons pu montrer/expliquer l'architecture aux nouvelles recrues. Avantages : Aide à la modélisation Aide au processus d'intégration Aide à garantir que nos projets sont bien documentés. ### 2. Mon projet documenté avec excellence dans phpDocumentor. **Rating:** 5.0/5.0 stars **Reviewed by:** Daniel D. | Petite entreprise (50 employés ou moins) **Reviewed Date:** September 28, 2020 **Qu'aimez-vous le plus à propos de phpDocumentor?** L'installation que l'outil m'a proposée pour générer la documentation directement à partir de la source du code PHP rend mon projet plus robuste et original, en utilisant l'outil javadoc qui me permet d'ajouter des commentaires pertinents et de supprimer la documentation répétitive, formant une documentation unique en plusieurs formats, avec un grand objectif pour moi de fournir tous les outils et ressources nécessaires pour rédiger une documentation efficace et complète avec le moins d'effort possible. Ayant un système de modèles flexible permettant de modifier la sortie de différentes manières et avec divers modèles, cadres, architectures enfichables, tels que WordPress ou PyroCms, entre autres. **Que n’aimez-vous pas à propos de phpDocumentor?** Il n'y avait pas de choses négatives pendant mon utilisation. Le logiciel a des fonctionnalités avec des fonctions qui ajoutent beaucoup à l'organisation. **Recommandations à d’autres personnes envisageant phpDocumentor:** Je le recommande car il était facile de documenter mon projet avec les outils et ressources proposés par phpDocumentor, et de laisser mon projet d'auteur avec les outils mentionnés ci-dessus et robuste avec une bibliothèque bien documentée grâce à javadoc. Avec plusieurs modèles de sortie Html très flexibles et une analyse de code permettant d'extraire des informations sous forme de graphiques et de rapports, facilitant son interprétation. **Quels sont les problèmes que phpDocumentor résout, et en quoi cela vous est-il bénéfique?** Mon entreprise avait besoin d'une documentation de projet où j'ai trouvé phpDocumentor un outil facile à utiliser, où j'ai utilisé le composer (installateur) à l'intérieur de mon serveur et une bonne partie du cmd facile à utiliser pour créer ma documentation, derrière le @tag (@ author, @version) et après je commence ma programmation. ### 3. phpDocumentor - probablement le service le plus nécessaire ! **Rating:** 5.0/5.0 stars **Reviewed by:** Pavlo P. | Petite entreprise (50 employés ou moins) **Reviewed Date:** December 24, 2020 **Qu'aimez-vous le plus à propos de phpDocumentor?** phpDocumentor est un outil et un format de documentation de code très populaire pour PHP. **Que n’aimez-vous pas à propos de phpDocumentor?** L'une des plus grandes contrariétés de PhpDocumentor était d'essayer d'écrire une documentation de type DocBook pour une partie du manuel, et une documentation de type docblock pour une autre partie. **Quels sont les problèmes que phpDocumentor résout, et en quoi cela vous est-il bénéfique?** Cela prend beaucoup de temps pour écrire la documentation. PHPDoc peut faire presque tout par lui-même. ### 4. PhpDocumentor est un excellent outil **Rating:** 4.0/5.0 stars **Reviewed by:** Utilisateur vérifié à Technologie de l'information et services | Petite entreprise (50 employés ou moins) **Reviewed Date:** December 03, 2020 **Qu'aimez-vous le plus à propos de phpDocumentor?** Ceci est utile car nous pouvons les parcourir plus rapidement que les fichiers de code, et obtenir une très bonne documentation qui peut être distribuée à tous les développeurs de l'équipe, aux prestataires de services tiers ou aux nouvelles personnes de votre équipe sans beaucoup de travail supplémentaire. **Que n’aimez-vous pas à propos de phpDocumentor?** C'est presque obsolète.. Il n'y a plus de développement ou d'amélioration significative. **Quels sont les problèmes que phpDocumentor résout, et en quoi cela vous est-il bénéfique?** C'est formidable de créer des documents API, cela aide l'IDE car il pourra vous donner plus de détails sur les types de paramètres et de méthodes que vos classes fournissent et nécessitent. ### 5. Meilleur document pour PHP **Rating:** 4.0/5.0 stars **Reviewed by:** Sawan N. | Technical Analyst, Petite entreprise (50 employés ou moins) **Reviewed Date:** December 01, 2020 **Qu'aimez-vous le plus à propos de phpDocumentor?** La facilité de l'interface utilisateur et le contenu global est très instructif. **Que n’aimez-vous pas à propos de phpDocumentor?** Avec les sujets, il devrait y avoir plus d'exemples. **Recommandations à d’autres personnes envisageant phpDocumentor:** Le contenu est vraiment bon, on devrait essayer au moins une fois. **Quels sont les problèmes que phpDocumentor résout, et en quoi cela vous est-il bénéfique?** Cela m'aide à améliorer mes compétences fondamentales en PHP. ### 6. PHPDoc contre Swagger **Rating:** 5.0/5.0 stars **Reviewed by:** Mohsen A. | Senior Backend Developer / Architect / Lead , Petite entreprise (50 employés ou moins) **Reviewed Date:** November 27, 2019 **Qu'aimez-vous le plus à propos de phpDocumentor?** Syntaxe facile Pris en charge par les IDE Intégré dans le code **Que n’aimez-vous pas à propos de phpDocumentor?** Pas de support pour les paramètres avec des tableaux typés imbriqués ni pour les tableaux de paires clé-valeur. **Recommandations à d’autres personnes envisageant phpDocumentor:** J'ai eu de l'expérience avec Swagger et PHPDoc. Swagger est complexe et prend du temps pour rédiger des documents. PHPDoc offre une seule manière simple d'écrire des documents au milieu du code. La seule fonctionnalité manquante avec PHPDoc est le manque de support pour les tableaux typés imbriqués ainsi que les tableaux clé-valeur. **Quels sont les problèmes que phpDocumentor résout, et en quoi cela vous est-il bénéfique?** Les documenteurs de code source résolvent deux problèmes principaux : "Livraison de code source" et "Référencement d'API". Les deux outils de documentation bien connus pour PHP sont PHPDoc et Swagger. Swagger fournit une solution plus complexe pour documenter le code PHP. Vous pouvez soit intégrer la syntaxe au milieu du code, soit simplement créer des fichiers séparés pour la documentation. Les classes doivent être mappées indépendamment, ce qui rend la rédaction d'un document plus chronophage. Même la syntaxe intégrée est difficile à écrire. D'autre part, la seule chose que vous devez faire avec PHPDoc est d'écrire votre document au-dessus de vos définitions. La syntaxe est claire, a un support natif par les IDE populaires, y compris PHPStorm, Netbeans, etc., et dans l'ensemble, tout se déplace très facilement. ### 7. J'utilise PHPDocumentor pour générer des commentaires. **Rating:** 4.5/5.0 stars **Reviewed by:** Utilisateur vérifié à Jeux informatiques | Petite entreprise (50 employés ou moins) **Reviewed Date:** July 23, 2020 **Qu'aimez-vous le plus à propos de phpDocumentor?** Automate la génération de commentaires. Les commentaires ont la structure correcte. **Que n’aimez-vous pas à propos de phpDocumentor?** Les commentaires, dans de très rares cas, nécessitent une correction. **Recommandations à d’autres personnes envisageant phpDocumentor:** Ils devraient essayer et ensuite prendre une décision. **Quels sont les problèmes que phpDocumentor résout, et en quoi cela vous est-il bénéfique?** J'utilise phpDocumentor pour générer des commentaires. ### 8. Excellent outil pour l'auto-documentation dans les codes PhP générés. **Rating:** 4.5/5.0 stars **Reviewed by:** Margareth S. | Computer Technical Specialist, Entreprise (> 1000 employés) **Reviewed Date:** August 21, 2019 **Qu'aimez-vous le plus à propos de phpDocumentor?** J'aime vraiment sa fonctionnalité elle-même, c'est un outil qui nous permet d'auto-documenter le code que nous avons écrit en langage PHP et cela se fait automatiquement en utilisant le code source. J'aime vraiment qu'en utilisant un outil comme celui-ci pour tout le code que nous programmons, cela nous permet d'avoir une sorte de modèle de documentation que nos codes ont et de pouvoir comprendre plus facilement ce qui est programmé et quelles fonctions se trouvent dans chaque section. J'aime vraiment que l'utilisation de cet outil nous permette de continuer facilement le code laissé par un autre programmeur ou qu'un collaborateur continue facilement le code créé par nous puisqu'il nous permet d'avoir une bonne documentation. J'aime aussi beaucoup qu'il nous permette de migrer tout le code vers un fichier HTML avec un grand niveau de détail de tout, des commentaires aux fonctions, variables, entre autres choses. **Que n’aimez-vous pas à propos de phpDocumentor?** Fondamentalement, le seul point négatif est la petite communauté qu'il a et ce n'est peut-être pas un outil qui a encore reçu la reconnaissance qu'il mérite, mais la vérité est que c'est un outil qui oblige le programmeur à avoir une bonne pratique de codage. **Recommandations à d’autres personnes envisageant phpDocumentor:** Je ne vois vraiment aucune raison de ne pas recommander cet outil, je pense qu'il est excellent et que la vérité est un outil qui finira par nous apporter de nombreux avantages, tant lors de la mise à jour d'une application que lors de l'ajout de nouvelles fonctions à un système. **Quels sont les problèmes que phpDocumentor résout, et en quoi cela vous est-il bénéfique?** C'est un outil qui a été très utile pour moi, il m'a permis d'améliorer les bonnes pratiques de programmation, en me forçant à remplir les champs de documentation nécessaires pour comprendre facilement le code, et il a également été très utile dans le domaine du travail lors de l'embauche d'un nouveau programmeur ou en ayant besoin de la collaboration d'un tiers. ### 9. Php documentor est un excellent outil pour générer de la documentation à partir du code source. **Rating:** 4.0/5.0 stars **Reviewed by:** Wolfred M. | Full Stack Developer, Petite entreprise (50 employés ou moins) **Reviewed Date:** May 15, 2019 **Qu'aimez-vous le plus à propos de phpDocumentor?** - Php documentor a plusieurs modèles afin d'avoir une documentation plus agréable à la vue de l'utilisateur. - Php documentor est capable d'interpréter les informations pour créer des graphiques et des rapports. - Php documentor a une section importante pour signaler tous les `TODO` qui sont placés dans le code. - Php documentor crée l'ensemble du wiki pour toutes les fonctions, y compris le constructeur et les constantes pour chaque classe. **Que n’aimez-vous pas à propos de phpDocumentor?** - Malgré le fait qu'il ait plusieurs modèles, il semble que les modèles soient trop anciens pour les outils HTML actuels. - L'installation n'est pas facile à réaliser. **Recommandations à d’autres personnes envisageant phpDocumentor:** Les nouveaux modèles pourraient être utilisés avec les nouveaux outils HTML 5. **Quels sont les problèmes que phpDocumentor résout, et en quoi cela vous est-il bénéfique?** Mon entreprise doit avoir une documentation très claire pour que les développeurs comprennent mieux le code, en particulier lorsqu'un nouvel employé rejoint l'entreprise. ### 10. phpDocumentor **Rating:** 5.0/5.0 stars **Reviewed by:** Mirian M. | OpenNebula, Marché intermédiaire (51-1000 employés) **Reviewed Date:** March 02, 2019 **Qu'aimez-vous le plus à propos de phpDocumentor?** C'est le maximum puisque, en tant que programmeur et pour les temps d'exécution, il est difficile de commenter le code, cet outil fait l'analyse du code source et génère un fichier suivant les normes de programmation, ce qui aide à comprendre ses propres codes et ceux des autres programmeurs. **Que n’aimez-vous pas à propos de phpDocumentor?** Cela ne fonctionne pas mais vous suivez certains paramètres ou normes de la programmation, cela peut vous donner des échecs. **Recommandations à d’autres personnes envisageant phpDocumentor:** utilisez-le. recommandez. **Quels sont les problèmes que phpDocumentor résout, et en quoi cela vous est-il bénéfique?** Documentation complète du système réalisée sous le langage PHP ## phpDocumentor Discussions - [À quoi sert phpDocumentor ?](https://www.g2.com/fr/discussions/what-is-phpdocumentor-used-for) - [sdgsfgsfdgsdfgsdfgdsfdsf](https://www.g2.com/fr/discussions/34466-sdgsfgsfdgsdfgsdfgdsfdsf) - 1 upvote ## Top phpDocumentor Alternatives - [Okta](https://www.g2.com/fr/products/okta/reviews) - 4.5/5.0 (1,159 reviews) - [Termius](https://www.g2.com/fr/products/termius/reviews) - 4.8/5.0 (248 reviews) - [SAP Fiori](https://www.g2.com/fr/products/sap-fiori/reviews) - 4.3/5.0 (124 reviews)