Php/docs/function.system

提供:Dev Guides
< Php
移動先:案内検索

system

(PHP 4, PHP 5, PHP 7)

system外部プログラムを実行し、出力を表示する


説明

system ( string $command [, int &$return_var ] ) : string

system() は、指定した command を実行し、結果を出力する C 言語の system 関数に似ています。

PHP をサーバーモジュールとして実行している場合、 system() のコールにより、各行を出力した後、 Web サーバーの出力バッファが自動的にクリアされます。

コマンドを実行し、何の加工もせずに全てのデータをコマンドから直接 返す必要がある場合、passthru() 関数を使用してください。


パラメータ

command
実行するコマンド。
return_var
引数 return_var が存在する場合、 実行したコマンドの返すステータスがこの変数に書かれます。


返り値

成功時はコマンド出力の最後の行を返し、失敗時は false を返します。


例1 system() の例

<?phpecho '<pre>';// シェルコマンド "ls" の全ての結果を出力し、出力の最後の// 行を $last_line に格納します。シェルコマンドの戻り値は// $retval に格納されます。$last_line = system('ls', $retval);// 追加情報を表示します。echo '</pre><hr />Last line of the output: ' . $last_line . '<hr />Return value: ' . $retval;?>

注意

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


注意:

プログラムがこの関数で始まる場合、 バックグラウンドで処理を続けさせるには、 プログラムの出力をファイルや別の出力ストリームにリダイレクトする必要があります。 そうしないと、プログラムが実行を終えるまで PHP はハングしてしまいます。

参考