# passthru

(PHP 4, PHP 5, PHP 7)

passthru — 执行外部程序并且显示原始输出

### 说明

passthru ( string `$command` [, int `&$return_var` ] ) : void

同 exec() 函数类似， passthru() 函数 也是用来执行外部命令（`command`）的。 当所执行的 Unix 命令输出二进制数据， 并且需要直接传送到浏览器的时候， 需要用此函数来替代 exec() 或 system() 函数。 常用来执行诸如 pbmplus 之类的可以直接输出图像流的命令。 通过设置 Content-type 为 image/gif， 然后调用 pbmplus 程序输出 gif 文件， 就可以从 PHP 脚本中直接输出图像到浏览器。

### 参数

`command`

  要执行的命令。

`return_var`

  如果提供 `return_var` 参数， Unix 命令的返回状态会被记录到此参数。

### 返回值

没有返回值。

### 注释

Warning

当用户提供的数据传入此函数，使用 escapeshellarg() 或 escapeshellcmd() 来确保用户欺骗系统从而执行任意命令。

> Note:

> 如何程序使用此函数启动，为了能保持在后台运行，此程序必须将输出重定向到文件或其它输出流。否则会导致 PHP 挂起，直至程序执行结束。

> Note: 安全模式 启用时，可仅可用 safe_mode_exec_dir 执行文件。实际上，现在不允许在到可执行的路径中存在 .. 组件。

Warning

安全模式 启用时，命令字符串会被 escapeshellcmd() 转换。因此，echo y | echo x 会变成 echo y \| echo x。

### 参见

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