NetBeansでPhpDocを作成

1月 21st, 2012 by admin Leave a reply »

NetBeans7.1でPhpDocumentorを使うのに苦戦したのでメモ。

まずは、PhpDocumentor本体をローカルで動くように設定。
xamppには標準装備されてるらしいですが、
新たに取得して動かすようにしてみた。

PhpDocumentor:http://www.phpdoc.org/

解凍した中身を自分の場合は
C:\xampp\htdocs\PhpDocumentor-1.4.4
に配置することにした。

NetBeans側ではphpdoc.batのパスを設定

オプションに -o HTML:Smarty:PHP を指定して
テンプレートをデフォルトから変更。

せっかちな僕はさっそく実行してみると・・

** ERROR *****************************************************************
* Sorry, can't find the php.exe file.
* You must edit this file to point to your php.exe (CLI version!)
* [Currently set to C:\_xampp\php\php.exe]
*
* NOTE: In PHP 4.2.x the PHP-CLI used to be named php-cli.exe.
* PHP 4.3.x renamed it php.exe but stores it in a subdir
* called /cli/php.exe
* E.g. for PHP 4.2 C:\phpdev\php-4.2-Win32\php-cli.exe
* for PHP 4.3 C:\phpdev\php-4.3-Win32\cli\php.exe
**************************************************************************
続行するには何かキーを押してください . . . .

ふふふ・・
ここからけっこー動くまで長い旅になった。

phpdoc.batを右クリックから編集をして
ファイルの中身を書き換えます。


::----------------------------------------------------------------------------------
:: Please set following to PHP's CLI
:: NOTE: In PHP 4.2.x the PHP-CLI used to be named php-cli.exe.
:: PHP 4.3.x names it php.exe but stores it in a subdir called /cli/php.exe
:: E.g. for PHP 4.2 C:\phpdev\php-4.2-Win32\php-cli.exe
:: for PHP 4.3 C:\phpdev\php-4.3-Win32\cli\php.exe

SET phpCli=C:\_xampp\php\php.exe
cd C:\xampp\htdocs\PhpDocumentor-1.4.4

↑のようにphp.exeのパスを換えてPhpDocumentorのパスに変更。

SET phpCli= ローカルphp.exeのパス
を変更しただけだと、
NetBeansコンソールにはCould not open input file: phpdoc
ってエラーがでたので
きっとphpdocコマンドが通る状態になってなかったと。

解決策としてよくわからんけどcdでフォルダの移動・・。

とりあえずこれで動いたっぽい。

・・・だだし、対象フォルダの指定ができないようなので
プロジェクトから全て検索されるようだ。
ターゲットディレクトイは対象を指すのではなくて出力の保存先。

プロジェクトファイルが多いとphpのメモリーオーバーで
ドキュメント化できない。
php.iniでmemory_limit増やす必要があるようです。

Advertisement

コメントを残す