system

(PHP 3, PHP 4, PHP 5)

system -- 外部プログラムの実行と表示

説明

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

system()は、指定した commandを実行し、結果を出力するC言語の system関数に似ています。2番目の引数として変数が指定された場合、実 行したコマンドのステータスコードが、この変数に書き込まれます。

警告

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

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

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

成功時にコマンド出力の最後の行が返され、失敗時にFALSEが返されます。

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

例 1. system()の例

<?php
echo '<pre>';

// Outputs all the result of shellcommand "ls", and returns
// the last output line into $last_line. Stores the return value
// of the shell command in $retval.
$last_line = system('ls', $retval);

// Printing additional info
echo '
</pre>
<hr />Last line of the output: '
. $last_line . '
<hr />Return value: '
. $retval;
?>

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

警告

セーフモードが有効な場合、最初のコマンド文字列に続く全ての単語は単一の引数として扱われます。 つまり、echo y | echo x は、echo "y | echo x" となります。

exec(), passthru(), popen(), escapeshellcmd(), pcntl_exec(), および バックティック演算子 も参照ください。