# phpDocumentor Reviews **Vendor:** phpDocumentor **Category:** [Altri Software di Sviluppo](https://www.g2.com/it/categories/other-development) **Average Rating:** 4.3/5.0 **Total Reviews:** 12 ## About phpDocumentor phpDocumentor è uno strumento che rende possibile generare documentazione direttamente dal codice sorgente PHP. ## phpDocumentor Reviews ### 1. I miei incontri con PHPDocumentor **Rating:** 4.5/5.0 stars **Reviewed by:** Borislav S. | Piccola impresa (50 o meno dip.) **Reviewed Date:** January 01, 2021 **Cosa ti piace di più di phpDocumentor?** - Facilità d'uso - Generazione diretta della documentazione dal codice e visibilità dei commenti nel sorgente - Connessione diretta alla gerarchia di classi/namespace - Ho trovato la funzione di generazione UML piuttosto utile poiché utilizziamo strumenti di modellazione - Configurazione relativamente semplice anche per progetti legacy e supporto immediato tramite PHAR (bello!) - Mi piace il fatto che supporti il tuo codice generando la tua documentazione con PHPDocumentor **Cosa non ti piace di phpDocumentor?** Ho trovato un po' difficile controllare come le cose sono organizzate nel risultato finale. Ad esempio, un ordinamento personalizzato di classi/spazi dei nomi sarebbe fantastico. **Quali problemi sta risolvendo phpDocumentor e come ti sta beneficiando?** Problemi complessivi: Siamo stati in grado di mostrare la nostra documentazione nel codice esternamente - ai nostri sviluppatori o appaltatori. Siamo stati in grado di visualizzare in anteprima il nostro approccio di modellazione durante il tempo di sviluppo. Siamo stati in grado di mostrare/spiegare l'architettura ai nuovi assunti. Benefici: Aiuta con la modellazione Aiuta con il processo di inserimento Aiuta a garantire che i nostri progetti siano ben documentati ### 2. Il mio progetto documentato con eccellenza in phpDocumentor. **Rating:** 5.0/5.0 stars **Reviewed by:** Daniel D. | Piccola impresa (50 o meno dip.) **Reviewed Date:** September 28, 2020 **Cosa ti piace di più di phpDocumentor?** La funzionalità che lo strumento mi ha proposto per generare la documentazione direttamente dal codice sorgente PHP rende il mio progetto più robusto e autoriale, utilizzando lo strumento javadoc che mi permette di aggiungere commenti rilevanti e scartare documentazione ripetitiva, formando una documentazione unica in diversi formati, con un grande obiettivo per me di fornire tutti gli strumenti e le risorse necessarie per scrivere documentazione efficace e completa con il minimo sforzo possibile. Avendo un sistema di template flessibile che ti permette di cambiare il tuo output in modi diversi e con vari modelli, framework, architetture plug-in, come WordPress o PyroCms, tra gli altri. **Cosa non ti piace di phpDocumentor?** Non ci sono state cose negative durante il mio utilizzo. Il software ha funzionalità con funzioni che aggiungono molto all'organizzazione. **Raccomandazioni per chi sta considerando phpDocumentor:** Lo consiglio perché è stato facile documentare il mio progetto con gli strumenti e le risorse che phpDocumentor ha proposto, e lasciare il mio progetto autore con gli strumenti sopra menzionati e robusto con una libreria ben documentata tramite javadoc. Con diversi modelli di output Html molto flessibili e ha un'analisi del codice da cui estrarre informazioni in grafici e report, facilitandone l'interpretazione. **Quali problemi sta risolvendo phpDocumentor e come ti sta beneficiando?** La mia azienda aveva bisogno di una documentazione di progetto dove ho trovato phpDocumentor uno strumento facile da usare, dove ho utilizzato il composer (installer) all'interno del mio server e una buona parte del cmd facile da usare per creare la mia documentazione, dietro il @tag (@author, @version) e dopo inizio la mia programmazione. ### 3. Ottima documentazione del codice PHP **Rating:** 4.0/5.0 stars **Reviewed by:** Dolly Aswin H. | Founder, Piccola impresa (50 o meno dip.) **Reviewed Date:** January 20, 2021 **Cosa ti piace di più di phpDocumentor?** Ho iniziato a usare phpDocumentor dal 2010. E questo strumento è molto utile per documentare la mia libreria PHP. **Cosa non ti piace di phpDocumentor?** Per me, non ci sono stati svantaggi con phpDocumentor. Ma è solo necessario avere la disciplina di eseguirlo per aggiornare la documentazione del codice. **Quali problemi sta risolvendo phpDocumentor e come ti sta beneficiando?** Nel mio team, sviluppiamo la nostra libreria. E la documentazione del codice è stata molto utile per comprendere la struttura del codice, le classi e i metodi. Qual è lo scopo del metodo e qual è il risultato atteso. E quando un nuovo sviluppatore si unisce, può imparare da questa documentazione. ### 4. Php documentor Ottimo strumento **Rating:** 4.0/5.0 stars **Reviewed by:** Utente verificato in Tecnologia dell'informazione e servizi | Piccola impresa (50 o meno dip.) **Reviewed Date:** December 03, 2020 **Cosa ti piace di più di phpDocumentor?** Questo è utile perché possiamo navigarli più velocemente dei file di codice e ottenere una documentazione molto bella che può essere distribuita a tutti gli sviluppatori del team, ai fornitori di servizi terzi o ai nuovi membri del tuo team senza molto lavoro aggiuntivo. **Cosa non ti piace di phpDocumentor?** È quasi obsoleto.. Non ci sono più sviluppi o miglioramenti significativi **Quali problemi sta risolvendo phpDocumentor e come ti sta beneficiando?** È fantastico creare documenti API, aiuta l'IDE poiché sarà in grado di fornire più dettagli su quali tipi di parametri e metodi le tue classi offrono e di cui hanno bisogno. ### 5. Miglior documento per PHP **Rating:** 4.0/5.0 stars **Reviewed by:** Sawan N. | Technical Analyst, Piccola impresa (50 o meno dip.) **Reviewed Date:** December 01, 2020 **Cosa ti piace di più di phpDocumentor?** La facilità dell'interfaccia utente e il contenuto complessivo sono molto istruttivi. **Cosa non ti piace di phpDocumentor?** Oltre agli argomenti, ci dovrebbero essere più esempi. **Raccomandazioni per chi sta considerando phpDocumentor:** Il contenuto è davvero buono, uno dovrebbe provare almeno una volta. **Quali problemi sta risolvendo phpDocumentor e come ti sta beneficiando?** Mi aiuta a migliorare le mie competenze di base in PHP. ### 6. PHPDoc contro Swagger **Rating:** 5.0/5.0 stars **Reviewed by:** Mohsen A. | Senior Backend Developer / Architect / Lead , Piccola impresa (50 o meno dip.) **Reviewed Date:** November 27, 2019 **Cosa ti piace di più di phpDocumentor?** Sintassi facile Supportato dagli IDE Incorporato nel codice **Cosa non ti piace di phpDocumentor?** Nessun supporto per parametri con array tipizzati annidati né per array chiave-valore. **Raccomandazioni per chi sta considerando phpDocumentor:** Ho avuto esperienza sia con Swagger che con PHPDoc. Swagger è complesso e richiede molto tempo per scrivere documenti. PHPDoc offre solo un modo semplice per scrivere documenti nel mezzo del codice. Se stai scegliendo tra i due, probabilmente suggerirei PHPDoc. L'unica caratteristica mancante di PHPDoc è la mancanza di supporto per array tipizzati annidati così come per array chiave-valore. **Quali problemi sta risolvendo phpDocumentor e come ti sta beneficiando?** I documentatori del codice sorgente risolvono due problemi principali: "Consegna del codice sorgente" e "Riferimento API". I due strumenti di documentazione ben noti per PHP sono PHPDoc e Swagger. Swagger fornisce una soluzione più complessa per documentare il codice PHP. Puoi incorporare la sintassi nel mezzo del codice o semplicemente creare file separati per la documentazione. Le classi devono essere mappate indipendentemente, il che rende più dispendioso in termini di tempo scrivere un documento. Anche la sintassi incorporata è difficile da scrivere. D'altra parte, l'unica cosa che devi fare con PHPDoc è scrivere il tuo documento sopra le tue definizioni. La sintassi è pulita, ha supporto nativo da parte degli IDE popolari, inclusi PHPStorm, Netbeans, ecc. e complessivamente tutto si muove molto facilmente. ### 7. Uso PHPDocumentor per generare commenti. **Rating:** 4.5/5.0 stars **Reviewed by:** Utente verificato in Videogiochi | Piccola impresa (50 o meno dip.) **Reviewed Date:** July 23, 2020 **Cosa ti piace di più di phpDocumentor?** Automatizzare la generazione di commenti. I commenti hanno la struttura corretta. **Cosa non ti piace di phpDocumentor?** I commenti in casi molto rari necessitano di correzione. **Raccomandazioni per chi sta considerando phpDocumentor:** Dovrebbero provare e poi prendere una decisione. **Quali problemi sta risolvendo phpDocumentor e come ti sta beneficiando?** Uso phpDocumentor per generare commenti. ### 8. Eccellente strumento per l'auto-documentazione nei codici PHP generati **Rating:** 4.5/5.0 stars **Reviewed by:** Margareth S. | Computer Technical Specialist, Enterprise (> 1000 dip.) **Reviewed Date:** August 21, 2019 **Cosa ti piace di più di phpDocumentor?** Mi piace molto la sua funzionalità in sé, è uno strumento che ci permette di auto-documentare il codice che abbiamo scritto nel linguaggio PHP e questo viene fatto automaticamente utilizzando il codice sorgente. Mi piace molto che utilizzando uno strumento come questo per tutto il codice che programmiamo, ci permette di avere una sorta di modello di documentazione che i nostri codici hanno e di poter comprendere più facilmente ciò che è programmato e quali funzioni si trovano in ogni sezione. Mi piace molto che l'uso di questo strumento ci permetta di continuare facilmente il codice lasciato da qualche altro programmatore o che qualche collaboratore continui facilmente il codice creato da noi poiché ci permette di avere una buona documentazione. Mi piace anche molto che ci permetta di migrare l'intero codice in un file HTML con un grande grado di dettaglio di tutto, dai commenti alle funzioni, variabili, tra le altre cose. **Cosa non ti piace di phpDocumentor?** Fondamentalmente l'unico aspetto negativo è la piccola comunità che ha e che forse non è ancora uno strumento che ha ricevuto il riconoscimento che merita, ma la verità è che è uno strumento che costringe il programmatore ad avere una buona pratica di codifica. **Raccomandazioni per chi sta considerando phpDocumentor:** Non vedo davvero alcun motivo per non raccomandare questo strumento, penso che sia eccellente e che la verità sia uno strumento che alla fine ci porterà molti vantaggi, sia quando si aggiorna un'applicazione sia quando si aggiungono nuove funzioni a qualche sistema. **Quali problemi sta risolvendo phpDocumentor e come ti sta beneficiando?** È uno strumento che è stato molto utile per me, mi ha fatto migliorare le buone pratiche di programmazione, costringendomi a compilare i campi di documentazione necessari per comprendere facilmente il codice, ed è stato anche super utile nel campo del lavoro quando si assume un nuovo programmatore o si ha bisogno della collaborazione di una terza parte. ### 9. PhpDocumentor è un ottimo strumento per generare documentazione dal codice sorgente. **Rating:** 4.0/5.0 stars **Reviewed by:** Wolfred M. | Full Stack Developer, Piccola impresa (50 o meno dip.) **Reviewed Date:** May 15, 2019 **Cosa ti piace di più di phpDocumentor?** - Php Documentor ha diversi modelli per rendere la documentazione più gradevole alla vista dell'utente. - Php Documentor è in grado di interpretare le informazioni per creare grafici e report. - Php Documentor ha una sezione importante per riportare tutti i `TODO` che si trovano nel codice. - Php Documentor crea l'intera wiki per tutte le funzioni; anche il costruttore e le costanti per ogni classe. **Cosa non ti piace di phpDocumentor?** - Nonostante abbia molti modelli, sembra che i modelli siano troppo vecchi per gli strumenti HTML attuali. - L'installazione non è facile da eseguire. **Raccomandazioni per chi sta considerando phpDocumentor:** I nuovi modelli potrebbero essere utilizzati con i nuovi strumenti HTML 5. **Quali problemi sta risolvendo phpDocumentor e come ti sta beneficiando?** La mia azienda deve avere una documentazione molto chiara affinché gli sviluppatori comprendano meglio il codice, specialmente quando un nuovo assunto entra in azienda. ### 10. phpDocumentor **Rating:** 5.0/5.0 stars **Reviewed by:** Mirian M. | OpenNebula, Mid-Market (51-1000 dip.) **Reviewed Date:** March 02, 2019 **Cosa ti piace di più di phpDocumentor?** È il massimo poiché, come programmatore e per i tempi di esecuzione, è difficile commentare il codice, questo strumento analizza il codice sorgente e genera un file seguendo gli standard di programmazione, il che aiuta a comprendere i propri codici e quelli di altri programmatori. **Cosa non ti piace di phpDocumentor?** Non funziona, ma se segui certi parametri o standard della programmazione, può darti dei fallimenti. **Raccomandazioni per chi sta considerando phpDocumentor:** usalo. raccomandalo. **Quali problemi sta risolvendo phpDocumentor e come ti sta beneficiando?** Documentazione completa del sistema realizzata in linguaggio PHP ## phpDocumentor Discussions - [A cosa serve phpDocumentor?](https://www.g2.com/it/discussions/what-is-phpdocumentor-used-for) - [sdgsfgsfdgsdfgsdfgdsfdsf](https://www.g2.com/it/discussions/34466-sdgsfgsfdgsdfgsdfgdsfdsf) - 1 upvote ## Top phpDocumentor Alternatives - [Okta](https://www.g2.com/it/products/okta/reviews) - 4.5/5.0 (1,171 reviews) - [Termius](https://www.g2.com/it/products/termius/reviews) - 4.8/5.0 (249 reviews) - [SAP Fiori](https://www.g2.com/it/products/sap-fiori/reviews) - 4.3/5.0 (124 reviews)