passthru
(PHP 4, PHP 5)
passthru — 执行外部程序并且显示原始输出
说明
void passthru
( string $command
[, int &$return_var
] )
    同 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 元字符转义 执行运算符