blogPHPでWEB+DBシステムの開発をやっています。5分24秒PHPソースからドキュメントを生成する主要な3ツールを試してみました。どのツールもそれほど深くは調べていないのでインストール+アルファ程度の設定変更で試しています。環境はCentOS4.4+PHP5.2.3です。phpDocumentorPHPでできたツールです。pearコマンドでインストールできることもあって、PHPのドキュメントジェネレータとして人気があります。インストールpearコマンドでインストールできます。phpdocumentorドキュメント生成phpdocコマンドで生成します。ドキュメントを生成するだけなら設定ファイルの変更は不要です。PHPDocに代わるAPIドキュメント自動生成ツールDoxygenC++でできたツールです。DoxygenはC/C++、Javaをはじめ様々な言語についてドキュメントを生成することができます。どちらかと言うと、C/C++、Java、Pythonがメインのツールですが、PHPでも十分なドキュメントを生成することができます。インストールCentOS4用はRPMがあるのでyumコマンドでインストールできます。DoxygenただRPMは1.3.9ですので、最新版(1.5.3)がよければソースからインストールします。installドキュメント生成まず設定ファイルを生成します。-gで生成する設定ファイルのファイル名を指定します。ファイル名を指定しなければDoxyfileという設定ファイルがカレントディレクトリに生成されます。[config]次に設定ファイルを編集します。下記は最低限変更した方が良いと思う項目です。NOドキュメント生成コマンドを実行するとドキュメントが生成されます。Doxyfile[参考サイト]Doxygen[本家]Doxygen[日本語訳]PHPXRefPerlでできたツールです。phpDocumentorやDoxygenとは少し毛色が異なり、クラス図などは表示されません。上記2ツールはクラス構造などをドキュメント化しますが、PHPXRefはソースコード自体をドキュメント化するのを目的としています。Utilityから最新版ソース(0.7)をダウンロードして展開するだけでokです。設定ファイルを編集します。展開したディレクトリ内にあるphpxref.cfgが設定ファイルになります。ドキュメント出力ディレクトリ(省略すればカレントディレクトリに出力)OUTPUT=docドキュメント生成コマンドを実行するとドキュメントが生成されます。出力サンプルCakePHP1.1.17.5612のソースを各ツールで出力してみました。phpDocumentorDoxygenPHPXRefクラス構造を確認するならDoxygenが、ファイル構造を確認するならPHPXRefが良さそうです。Doxygenにはクセがあるようで、PEARパッケージのようにファイル名とクラス名が異なる場合は上手く生成ができませんでした。22:44面白いですね。私もPHPXRefで同じことをしていました。cssをなんとか見栄えよくできないか、と思ってます。16:33どうもですー。PHPXRefは良いですね。動作も軽いんでソース見るのに向いてます。HotDocument】http://www.hotdocument.net/を使っています。日本製だから、どのツールより綺麗に出ますね。VB/C++/C#/Javaを使っています。1:21残念ながら、生成結果のリンクが切れてました。