php 8.6从cli启动外部程序时,可把命令写成参数数组,让proc_open直接执行固定程序而不经过shell。标准输出和错误输出分别写到专用文件,能避免两个管道互相等待导致的常见死锁;数组形式并不授权执行任意用户指定的程序。

PHP官方文档中的proc_open相关说明。 图源:PHP Documentation Group(CC BY3.0)。
固定程序、工作目录和输出文件
<?php
if (PHP_SAPI !== 'cli') { throw new RuntimeException('仅用于CLI'); }
$out = tempnam(sys_get_temp_dir(), 'php86-out-');
$err = tempnam(sys_get_temp_dir(), 'php86-err-');
if ($out === false || $err === false) {
if (is_string($out)) { unlink($out); }
if (is_string($err)) { unlink($err); }
throw new RuntimeException('创建临时文件失败');
}
try {
$command = [PHP_BINARY, '-n', '-r', 'fwrite(STDOUT, "ok\n"); fwrite(STDERR, "detail\n"); exit(3);'];
$spec = [0 => ['file', '/dev/null', 'r'], 1 => ['file', $out, 'w'], 2 => ['file', $err, 'w']];
$process = proc_open($command, $spec, $pipes, __DIR__, []);
if ($process === false) { throw new RuntimeException('启动失败'); }
$exitCode = proc_close($process);
printf("exit=%d\n", $exitCode);
echo file_get_contents($out, false, null, 0, 4096);
fwrite(STDERR, (string) file_get_contents($err, false, null, 0, 4096));
} finally {
if (is_file($out)) { unlink($out); }
if (is_file($err)) { unlink($err); }
}把退出码与内容分开处理
示例面向Unix类系统,/dev/null不是Windows路径。子程序会输出ok、detail并返回3,所以非零不等于没有输出。proc_close等待程序结束并释放进程资源,不要只根据stdout里出现某个词认定成功。空环境数组也可能影响真实程序的PATH和区域设置,应显式提供必要变量。
8.6迁移时检查cwd
PHP 8.6对含NUL字节的cwd抛出ValueError。工作目录应是已知、存在的绝对路径,不把HTTP参数直接传进去。代码采用PHP_BINARY的完整路径,避免PATH搜索到另一个程序;目标程序自己的参数仍需白名单校验。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

PHP官方文档中的proc_open相关说明。 图源:PHP Documentation Group(CC BY3.0)。
这个示例子程序是确定会结束的固定命令。真实程序可能无限运行或产生大量磁盘输出,应由进程监督、输出配额和截止时间限制;参数数组只避开Shell解释,不解决所有命令注入和资源消耗问题。


















