大网数据广告活动
PHP 语言与运行手册

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

· 52CE 我爱测

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

passthru

(PHP 4, PHP 5, PHP 7, PHP 8)

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

说明

function passthru(string $command, int &$result_code = null): ?false

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

参数

command

要执行的命令。

result_code

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

返回值

成功时返回 null, 或者在失败时返回 false。

错误/异常

如果 passthru() 无法执行 command,会发出 E_WARNING。

如果 command 为空或者包含 null 字节,则抛出 ValueError。

更新日志

版本 说明
8.0.0 如果 command 为空或者包含 null 字节,passthru() 现在将抛出 ValueError。之前会发出 E_WARNING 并返回 false。

注释

警告

当传入用户提供的数据到本函数时,应使用 escapeshellarg() 或 escapeshellcmd() 来防止用户欺骗系统执行任意命令。

注意:

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

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。