(PHP 4, PHP 5, PHP 7, PHP 8)
passthru — 执行外部程序并且显示原始输出
$command
, int &$result_code
= null
): ?bool
同 exec() 函数类似,
passthru() 函数
也是用来执行外部命令(command
)的。
当所执行的 Unix 命令输出二进制数据,
并且需要直接传送到浏览器的时候,
需要用此函数来替代 exec()
或 system() 函数。
常用来执行诸如 pbmplus 之类的可以直接输出图像流的命令。
通过设置 Content-type 为 image/gif
,
然后调用 pbmplus 程序输出 gif 文件,
就可以从 PHP 脚本中直接输出图像到浏览器。
command
要执行的命令。
result_code
如果提供 result_code
参数,
Unix 命令的返回状态会被记录到此参数。
成功时返回 null
, 或者在失败时返回 false
。
当传入用户提供的数据到本函数时,应使用 escapeshellarg() 或 escapeshellcmd() 来防止用户欺骗系统执行任意命令。
注意:
如何程序使用此函数启动,为了能保持在后台运行,此程序必须将输出重定向到文件或其它输出流。否则会导致 PHP 挂起,直至程序执行结束。