PHP マニュアル
前のページ |  | 次のページ

# 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 スクリプトを作成 することができます。

## パラメータ

`command`

  実行するコマンド

`return_var`

  引数`return_var`が存在する場合、 UNIX コマンドのステータスがこの変数に書かれます。

## 注意

警告
ユーザが入力したデータをこの関数に 渡すことを許可する場合、ユーザが任意のコマンドを実行できるようシステムを欺くことが できないように escapeshellarg() または escapeshellcmd() を適用する必要があります。

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

> 注意: セーフモード が有効な場合、 safe_mode_exec_dirの中にある実行プログラムのみ実行可能です。 実際的な理由により、現在、実行プログラムへのパスに `..`を 含めることはできません。

警告
セーフモードが有効な場合、コマンド文字列は escapeshellcmd() でエスケープされます。 つまり、`echo y | echo x` は、`echo y \| echo x` となります。

## 参考

exec()
system()
popen()
escapeshellcmd()
バックティック演算子

前のページ | ホーム | 次のページ
exec | 上に戻る | proc_close