# escapeshellarg

(PHP 4 >= 4.0.3, PHP 5, PHP 7)

escapeshellarg — 把字符串转码为可以在 shell 命令里使用的参数

### 说明

escapeshellarg ( string `$arg` ) : string

escapeshellarg() 将给字符串增加一个单引号并且能引用或者转码任何已经存在的单引号，这样以确保能够直接将一个字符串传入 shell 函数，并且还是确保安全的。对于用户输入的部分参数就应该使用这个函数。shell 函数包含 exec(), system() 执行运算符 。

### 参数

`arg`

  需要被转码的参数。

### 返回值

转换之后字符串。

### 范例

Example #1 escapeshellarg() 的例子

    <?php
    system('ls '.escapeshellarg($dir));
    ?>

### 参见

- escapeshellcmd() - shell 元字符转义
- exec() - 执行一个外部程序
- popen() - 打开进程文件指针
- system() - 执行外部程序，并且显示输出
- 执行运算符