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

# 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() - シェルのメタ文字をエスケープする