PHP proc_open 怎样为子进程连接标准输入输出和错误管道

在 PHP 里，proc_open() 连接子进程的关键不是把命令字符串写得多复杂，而是把三个标准描述符的方向声明清楚：0 是标准输入，1 是标准输出，2 是标准错误。descriptor_spec 决定子进程看到的端点，返回的 $pipes 则保存 PHP 这一侧的管道句柄。

下面用一个固定参数的 PHP CLI 子进程演示连接方式。示例只关注管道和资源关闭，不把外部输入拼接成命令。

官方地址：https://www.php.net/manual/en/function.proc-open.php

先看懂 descriptor_spec 的三个数字

descriptor_spec 是一个按描述符编号索引的数组。对最常见的三条管道来说，0、1、2 分别对应 stdin、stdout、stderr。方向要从子进程视角来写：stdin 用 r 表示子进程读取，stdout 和 stderr 用 w 表示子进程写出。

因此 PHP 侧拿到的 $pipes[0] 是写入 stdin 的句柄，$pipes[1] 和 $pipes[2] 分别用于读取 stdout 与 stderr。最容易写反的是 0 号管道：它对 PHP 来说是写，对子进程来说是读。

用固定参数建立三条连接

示例让子进程读取一行文本，并把结果写到标准输出；同时保留标准错误管道，方便把错误信息和正常结果分开处理。

 ['pipe', 'r'], // 子进程从标准输入读取。
    1 => ['pipe', 'w'], // 子进程向标准输出写入。
    2 => ['pipe', 'w'], // 子进程向标准错误写入。
];

$pipes = [];
$process = proc_open($command, $descriptorSpec, $pipes);
if (!is_resource($process)) {
    throw new RuntimeException('proc_open 建立进程失败'); // 失败时不要继续使用空句柄。
}

// PHP 侧写入 pipes[0]，对应子进程的 stdin。
fwrite($pipes[0], "hello pipes\n");
fclose($pipes[0]); // 写完必须关闭，让子进程收到 EOF。

// 分别读取正常输出和错误输出，避免把两类信息混在一起。
$stdout = stream_get_contents($pipes[1]);
$stderr = stream_get_contents($pipes[2]);
fclose($pipes[1]); // 关闭 PHP 侧 stdout 句柄。
fclose($pipes[2]); // 关闭 PHP 侧 stderr 句柄。

// 最后等待子进程结束并取得退出码。
$exitCode = proc_close($process);

echo $stdout;
if ($stderr !== '') {
    fwrite(STDERR, $stderr); // 错误流单独输出，便于日志系统分类。
}
echo "exit={$exitCode}\n";
?>

这里的判断顺序有两个重点：先确认 proc_open() 返回的是资源，再使用 $pipes；写完 stdin 后立即 fclose()，否则子进程可能一直等待更多输入。

为什么会出现读取卡住或进程不退出

这类问题通常不是 descriptor_spec 少写一行，而是管道两端的生命周期没有闭合。子进程如果持续写 stdout 或 stderr，而父进程只读取其中一路，另一条管道的缓冲区可能填满，双方就会互相等待。

• 只需要发送一次输入时，写完 $pipes[0] 就关闭，不要把句柄留到 proc_close()。
• stdout 和 stderr 都声明为 pipe 时，两边都要读取；不能只处理正常输出而忽略错误输出。
• 输出量较大时，不要用“先完整读 stdout、再完整读 stderr”的方案想当然地解决所有场景，应使用非阻塞读取配合 stream_select()，让两路有数据就及时排空。
• Windows 对本地管道的非阻塞行为有平台差异，跨平台代码要把系统差异当成设计条件，而不是只调整超时时间。

小输出可以直接读取，大输出要同时排空

像上面的短文本示例，先关闭输入，再读取两路输出，最后 proc_close() 足够清晰。若子进程可能产生大量日志，建议先将两个输出流切换为非阻塞，再用 stream_select() 轮询可读流；这样不会因为 stderr 没被及时读取而卡住。

非阻塞读取只是处理大输出的一种结构，不能替代资源清理。循环结束后仍要关闭两条输出管道，并调用 proc_close() 等待子进程完成。

正确的关闭顺序

可以把生命周期记成四步：建立进程句柄，写完后关闭 stdin，读取并关闭 stdout/stderr，最后调用 proc_close()。官方说明中，proc_close() 会等待进程终止，并关闭仍打开的管道；但把关闭动作显式写出来，排查阻塞时更容易定位责任。

1. 建立：proc_open() 成功后，确认 $pipes 中需要的句柄存在。
2. 输入结束：完成 fwrite() 后关闭 $pipes[0]，让子进程看到 EOF。
3. 输出排空：读取 stdout 和 stderr；大输出场景两路交替读取。
4. 收尾：关闭输出句柄，再用 proc_close() 取得退出码。

排查清单

总结

proc_open() 的连接模型可以压缩成一句话：用 descriptor_spec 描述子进程的 0/1/2 端点，用 $pipes 操作 PHP 侧句柄，写完输入就关闭，读取完两路输出再 proc_close()。小输出按顺序读取即可；输出量不可控时，要同时排空 stdout 和 stderr。

相关问题

为什么 stdin 的 r/w 看起来和 PHP 的操作方向相反？

它描述的是子进程拿到的端点。子进程读取 stdin，所以写成 r；PHP 拿到的是管道另一端，因此负责写入。

stdout 和 stderr 可以合并吗？

可以把 stderr 指向同一个文件或同一目标，但如果需要区分正常结果与诊断信息，就应保留两条 pipe 并分别读取。

proc_close() 能不能代替所有 fclose()？

它会关闭仍打开的管道，但显式关闭更能表达输入结束和输出已消费的边界，也更方便定位阻塞。