passthru
外部プログラムを実行し、未整形の出力を表示する
&reftitle.description;
falsenullpassthru
stringcommand
intresult_code&null;
passthru関数はexec関数と同様、
commandを実行します。
引数 return_code を指定した場合、
Unix コマンドのステータスで置換されます。
この関数は Unix コマンドからの出力がバイナリデータであり、
ブラウザーへ直接返す必要がある場合、exec
もしくはsystemの代わりに使用する必要があります。
よく使うのは、直接画像ストリームを出力することができる pbmplus
ユーティリティの様なものを実行する場合です。content-type を
image/gif に設定して、gifを出力するpbmplus
プログラムを呼び出すことにより、直接画像を出力する PHP スクリプトを作成
することができます。
&reftitle.parameters;
command
実行するコマンド
result_code
引数result_codeが存在する場合、
Unix コマンドのステータスがこの変数に書かれます。
&reftitle.returnvalues;
&return.nullorfalse;
&reftitle.errors;
passthru
が command
を実行できない場合、E_WARNING が発生します。
command
が空だったり、null バイトが含まれている場合、
ValueError がスローされます。
&reftitle.changelog;
&Version;
&Description;
8.0.0
command
が空だったり、null バイトが含まれている場合、
ValueError がスローされるようになりました。
これより前のバージョンでは、
E_WARNING が発生し、&false; を返していました。
&reftitle.notes;
&warn.escapeshell;
¬e.exec-bg;
&reftitle.seealso;
exec
system
popen
escapeshellcmd
バッククォート演算子