passthru

(PHP 3, PHP 4 , PHP 5)

passthru -- 外部プログラムを実行し、未整形の出力を表示します

説明

void passthru ( string command, int [return_var])

passthru()関数はexec()関数と同様、 commandを実行します。 引数 return_var を指定した場合、 Unix command のステータスで置換されます。 この関数は Unix command からの出力がバイナリデータであり、 ブラウザーへ直接返す必要がある場合、exec() もしくはsystem()の代わりに使用する必要があります。 よく使うのは、直接画像ストリームを出力することができる pbmplus ユーティリティの様なものを実行する場合です。content-type を image/gifに設定して、gifを出力するpbmplus プログラムを呼び出すことにより、直接画像を出力する PHP スクリプトを作成 することができます。

この関数を使用してプログラム実行を開始し、バックグラウンドで実行 したままにしたい場合には、プログラムの出力をファイルまたは他の出 力ストリームにリダイレクトする必要があることにも注意して下さい。 さもないと、PHPはそのプログラムの実行が終了するまでハングします。

exec(), system(), popen(), escapeshellcmd(), backtick 演算子 も参照下さい。