PhpDocumentor

phpDocumentor
Entwickler	Joshua Eichorn, Greg Beaver u.a.
Aktuelle Version	1.4.3 (5. September 2009)
Betriebssystem	Plattformunabhängig
Kategorie	Software-Dokumentationswerkzeug
Lizenz	LGPL
phpdoc.org

phpDocumentor ist ein Software-Dokumentationswerkzeug für PHP. Es steht als Freie Software unter der GNU Lesser General Public License. Mit der Software können Entwicklerdokumentationen aus PHP-Quelltexten generiert werden. Für diesen Zweck gilt phpDocumentor als Standardlösung.^[1][2] Das Programm kann als eigenständige Software installiert werden und ist fester Bestandteil des PHP Extension and Application Repository (PEAR).^[3]

Funktionen

Wie in anderen Software-Dokumentationswerkzeugen wird die Dokumentation durch spezielle Kommentare im Quelltext erfasst, zusätzlich wird die Struktur des Codes analysiert. Über Formatierungsanweisungen in den Kommentaren des Quelltextes können beispielsweise die Anzahl und der Typ von Parametern einer bestimmten Methode sowie deren Aufgabe und Rückgabewert dokumentiert werden.^[1] Die Kommentare basieren auf einer Adaption von JavaDoc^[4], dem sogenannten PHPDoc Standard. phpDocumentor wurde in PHP geschrieben und erstellt Dokumentationen in einer Vielzahl von Formaten wie HTML, PDF, CHM oder Docbook. phpDocumentor kann sowohl auf der Kommandozeile wie auch über ein Web-GUI bedient werden. phpDocumentor kennt sämtliche syntaktischen Elemente von PHP, es unterstützt sowohl PHP4 wie PHP5. Voraussetzung für die Nutzung der Software ist die Installation von PHP 4.3 oder höher.^[5]

phpDocumentor unterstützt keine Spracheigenschaften von PHP, die mit PHP 5.3 eingeführt wurden (z.B. Namespaces). Es wird zur Zeit nicht mehr aktiv weiterentwickelt (Stand November 2010).^[6]

Ähnliche Werkzeuge

• Javadoc
• Doxygen

Weblinks

• phpdoc.org Projektseite (englisch)

Literatur

• Andi Gutmans: PHP 5 aus erster Hand. Addison Wesley Verlag, 1. Auflage Mai 2005, S. 707 - 736. ISBN 978-3-8273-2241-8

Einzelnachweise

1. ↑ ^{a b} Markus Scholl: Konzeption und Teilrealisierung eines Seminarabwicklungssystems GRIN Verlag 2007, S. 86 ISBN 978-3-638-67799-8
2. ↑ Sebastian Bergmann:Professionelle Softwareentwicklung mit PHP 5. dpunkt.verlag, 1. Auflage 2005, Online-Version aktualisiert am 15. Januar 2009. ISBN 3-89864-229-1
3. ↑ [Carsten Möhrke: PHP PEAR. Galileo Computing. ISBN 3-89842-580-0 http://docs.cojobo.net/galileocomputing/php_pear/22_0_tools_and_utilities-002.htm]
4. ↑ George Schlossnagle: Professionelle PHP 5-programmierung. Addison-Wesley Februar 2006, S. 56. ISBN 978-3-8273-2381-1
5. ↑ Matthias Kannengiesser: Objektorientierte Programmierung mit PHP 5. Franzis Verlag, 1. Auflage April 2007, S. 529 ISBN 978-3-7723-6296-5
6. ↑ http://sourceforge.net/projects/phpdocu/forums/forum/35064