phpDocumentor

aus Wikipedia, der freien Enzyklopädie
Wechseln zu: Navigation, Suche
phpDocumentor
Entwickler Joshua Eichorn, Greg Beaver u. a.
Aktuelle Version 2.4.0[1]
(1. April 2014)
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.[2][3] Das Programm kann als eigenständige Software installiert werden und ist fester Bestandteil des PHP Extension and Application Repository (PEAR).[4]

Funktionen[Bearbeiten]

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.[2] Die Kommentare basieren auf PHPDoc, einer Adaption von Javadoc[5], 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.[6]

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).[7] Am 16. März 2012 erschien der Nachfolger phpDocumentor 2, welcher aus einem Zusammenschluss mit DocBlox entstand.[8]

Ähnliche Werkzeuge[Bearbeiten]

Weblinks[Bearbeiten]

Literatur[Bearbeiten]

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

Einzelnachweise[Bearbeiten]

  1. Release v2.4.0: Variadics and bug fixes Release Meldung auf GitHub
  2. a b Markus Scholl: Konzeption und Teilrealisierung eines Seminarabwicklungssystems GRIN Verlag 2007, S. 86 ISBN 978-3-638-67799-8
  3. Sebastian Bergmann:Professionelle Softwareentwicklung mit PHP 5. dpunkt.verlag, 1. Auflage 2005, Online-Version aktualisiert am 15. Januar 2009. ISBN 3-89864-229-1
  4. [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]
  5. George Schlossnagle: Professionelle PHP 5-programmierung. Addison-Wesley Februar 2006, S. 56. ISBN 978-3-8273-2381-1
  6. Matthias Kannengiesser: Objektorientierte Programmierung mit PHP 5. Franzis Verlag, 1. Auflage April 2007, S. 529 ISBN 978-3-7723-6296-5
  7. http://sourceforge.net/projects/phpdocu/forums/forum/35064
  8. http://www.docblox-project.org/2012/03/docblox-is-unmasked-it-is-really-phpdocumentor-2/