[ PHP Dynamic Script Tracer - User's Manual  ver1.1 ]

■PHP_Dyn -- PHP Dynamic Script Tracerとは？
・PHPスクリプトのデバッグを手助けする為のPHP Extensionです。
・PHPスクリプトに修正を加えずに、スクリプトの実行トレースを取得することができます。
・HTTPリクエストパラメータを表示することができます。
・関数呼び出し時の引数値、関数からのリターン値を表示することができます。
・各実行ステップの処理経過時間をマイクロ秒単位で表示します。

■動作環境
(1) PHP4.x
(2) PHPがApache DSO(Dynamic Shared Object)としてインストールしてあること

■インストール
(1) php_dyn-1.1.tgz を展開して下さい。
(2) ディレクトリ php_dyn-1.1 にて下記のコマンドを実行して下さい。
        ./configure
        make
(3) .libs/php_dyn.so を適当なディレクトリにコピーして下さい。
(4) php.iniに次の行を追加してください。
      zend_extension="/コピー先ディレクトリ/php_dyn.so"
    ※PHPを--enable-debugオプション付きでコンパイルした場合は、
      zend_debug_extension="/コピー先ディレクトリ/php_dyn.so"
    として下さい。
(5) apacheを再起動して下さい。

■設定オプション
正確な処理時間を測定したい場合、php.iniに下記の行を追加してください。
この場合、関数呼び出し時の引数内容、関数リターン時のリターン値の表示は行われません。
dyn.profiler_mode = On

ログファイル格納ディレクトリを変更したい場合、php.iniに下記の行を追加してください。
php.iniにこの行が無い場合、ログファイル格納ディレクトリは、/tmpです。
dyn.log_dir = /path

■使用方法
HTTPリクエストが発生する毎にPHPスクリプトのトレース結果がログファイルに出力されます。

■ログファイルの形式
・ログファイルPATH
　/tmp/php_dyn.log.(httpdプロセス番号)

・ログファイル内容
(コメント表示)
# コメント

(スクリプト実行開始表示)
@ time:スクリプト実行経過時刻(秒:マイクロ秒まで表示) (スクリプトPATH) スクリプト実行開始日時
$ $HTTP_POST_VARS=>
$     $HTTP_POST_VARS変数の値(ARRAY形式)
$ $HTTP_POST_FILES=>
$     $HTTP_POST_FILES変数の値(ARRAY形式)
$ $HTTP_GET_VARS=>
$     $HTTP_GET_VARS変数の値(ARRAY形式)
$ $HTTP_COOKIE_VARS=>
$     $HTTP_COOKIE_VARS変数の値(ARRAY形式)

(スクリプト通常処理表示)
| time:スクリプト実行経過時刻 (line:スクリプト処理行番号)

(スクリプトループ処理表示)
- time:スクリプト実行経過時刻 (line:スクリプト処理行番号)

(スクリプト関数またはスクリプトオブジェクトメソッド呼び出し処理表示)
- time:スクリプト実行経過時刻 CALL 関数名またはメソッド名 (呼び出し元スクリプトPATH line:スクリプト処理行番号) -> (呼び出し先スクリプトPATH line:スクリプト処理行番号)
$ arg:$引数1=>
$     $引数1の値
$ arg:$引数2=>
$     $引数2の値
$ arg:$引数n=>
$     $引数nの値

(スクリプト関数またはオブジェクトメソッドからのリターン処理表示)
※ 関数のリターン値を単純変数に代入する場合のみ、リターン値の表示を行います。
- time:スクリプト実行経過時刻 RETURN (リターン先スクリプトPATH line:スクリプト処理行番号) <- (リターン元スクリプトPATH line:スクリプト処理行番号)
$ return:
$     関数のリターン値

■更改履歴
2001/12/28    PHP Dynamic Script Tracer  ver1.0 公開
2002/02/14    ver1.1  PHP4.1.x対応

■著作権について
PHP Dynamic Script Tracerの著作権は、野田邦昌が保有します。
連絡先: http://www.pm9.com, kuni@pm9.com