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 スクリプトを作成 することができます。
注意
| 警告 |
|
ユーザが入力したデータをこの関数に 渡すことを許可する場合、ユーザが任意のコマンドを実行できるようシステムを欺くことが できないように escapeshellarg() または escapeshellcmd() を適用する必要があります。 |
注意: この関数を用いてプログラムを開始し、 バックグラウンドで実行させたままにしたい場合、このプログラムの出力をファイル または他の出力ストリームにリダイレクトするようにする必要があります。さもないと、 PHP はプログラム実行終了までにハングしてしまいます。
注意: セーフモード が有効な場合、 safe_mode_exec_dir の中にある実行プログラムのみ実行可能です。 実際的な理由により、現在、実行プログラムへのパスに .. を 含めることはできません。
| 警告 |
|
セーフモード が有効な場合、コマンド文字列は escapeshellcmd() でエスケープされます。 つまり、 echo y | echo x は、 echo y \| echo x となります。 |