Kein Wunder das jedes zweite PHP-Framework-Projekt ein eigenes, reflection-basiertes API-Dokumentationstool schreibt oder gar einen eigenen PEAR Channel Server. PEAR ist und bleibt der Schandfleck in der PHP Welt. Nachfolgend der Fehlerbericht für das Standardtool zur automatischen Quelltextdokumentierung “PEAR PhpDocumentor” v1.4.3(stable) (mit PHP 5.2.6). Das Teil ist als “stable” gekennzeichnet – “PEAR-stable” eben.
[PHP Error] Undefined index: pear [line 728 of /usr/share/php/PhpDocumentor/phpDocumentor/IntermediateParser.inc]
[PHP Error] Undefined index: pear [line 586 of /usr/share/php/PhpDocumentor/phpDocumentor/IntermediateParser.inc]
[PHP Error] Non-static method phpDocumentor_setup::checkIgnoreTag() should not be called statically, assuming $this from incompatible context [line 613 of /usr/share/php/PhpDocumentor/phpDocumentor/ParserDocBlock.inc]
[PHP Error] is_a(): Deprecated. Please use the instanceof operator [line 819 of /usr/share/php/PhpDocumentor/phpDocumentor/ParserData.inc]
[PHP Error] is_a(): Deprecated. Please use the instanceof operator [line 1400 of /usr/share/php/PhpDocumentor/phpDocumentor/ParserElements.inc]
[PHP Error] is_a(): Deprecated. Please use the instanceof operator [line 819 of /usr/share/php/PhpDocumentor/phpDocumentor/ParserData.inc]
[PHP Error] Non-static method phpDocumentor_setup::checkIgnoreTag() should not be called statically, assuming $this from incompatible context [line 820 of /usr/share/php/PhpDocumentor/phpDocumentor/ParserData.inc]
[PHP Error] Non-static method phpDocumentor_setup::checkIgnoreTag() should not be called statically, assuming $this from incompatible context [line 613 of /usr/share/php/PhpDocumentor/phpDocumentor/ParserDocBlock.inc]
[PHP Error] Only variables should be passed by reference [line 752 of /usr/share/php/PhpDocumentor/phpDocumentor/Setup.inc.php]
Man staunt und wundert sich.