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

system

(PHP 3, PHP 4, PHP 5)

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

説明

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

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

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

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

パラメータ

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

返り値

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

例

例 1. system() の例
<?php echo '<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 はプログラム実行終了までにハングしてしまいます。

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

警告

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

参考

exec()

passthru()

popen()

escapeshellcmd()

pcntl_exec()

バックティック演算子

前のページ	ホーム	次のページ
shell_exec	上に戻る	PostScript ドキュメントの作成

各種マニュアル： PHPマニュアル \| PEARマニュアル \| Smarty(英語)マニュアル \| PHP-GTKマニュアル \| 「system」をGoogle検索
copyright © 1997-2009 PHP ドキュメント作成グループ(ライセンス). provided by php spot.	マニュアル：