# shell_exec

(PHP 4, PHP 5, PHP 7)

shell_exec — 通过 shell 环境执行命令，并且将完整的输出以字符串的方式返回。

### 说明

shell_exec ( string `$cmd` ) : string

本函数同 执行操作符。

### 参数

`cmd`

  要执行的命令。

### 返回值

命令执行的输出。 如果执行过程中发生错误或者进程不产生输出，则返回 `NULL`。

> Note:

> 当进程执行过程中发生错误，或者进程不产生输出的情况下，都会返回 `NULL`， 所以，使用本函数无法通过返回值检测进程是否成功执行。 如果需要检查进程执行的退出码，请使用 exec() 函数。

### 范例

Example #1 shell_exec() 例程

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

### 注释

> Note:

> 当 PHP 运行在 安全模式 时，不能使用此函数。

### 参见

- exec() - 执行一个外部程序
- escapeshellcmd() - shell 元字符转义