shell_exec

(PHP 4, PHP 5, PHP 7)

shell_execシェルによりコマンドを実行し、文字列として出力全体を返す

説明

shell_exec ( string $cmd ) : string

この関数は バックティック演算子 と等価です。

パラメータ

cmd

実行するコマンド

返り値

実行されたコマンドからの出力を返します。 エラーが発生した場合やコマンドが何も出力しなかった場合は NULL を返します。

注意:

この関数は、エラーが発生した場合だけでなくプログラムが何も出力しなかった場合にも NULL を返します。 そのため、実行に失敗したかどうかをこの関数では判断できません。 プログラムの終了コードを調べる必要があるときには exec() を使いましょう。

例1 shell_exec() の例

<?php
$output 
shell_exec('ls -lart');
echo 
"<pre>$output</pre>";
?>

注意

注意:

この関数は、PHP が safe-mode で動作している場合は無効となります。

参考

  • exec() - 外部プログラムを実行する
  • escapeshellcmd() - シェルのメタ文字をエスケープする