proc_open必须显式关闭stdin/stdout/stderr管道，否则子进程因等待EOF而卡住、PHP脚本hang住；PHP7.2默认不自动关闭未用流，须按序fclose($pipes[0])→读$pipes[1]→fclose($pipes[1])→读$pipes[2]→fclose($pipes[2])→proc_close()。
proc_open 为什么必须显式关闭 stdin/stdout/stderr
不关管道会导致子进程卡住、PHP 脚本 hang 住，尤其在循环调用或 Web 环境下极易复现。PHP7.2 的 proc_open 默认不会自动关闭未使用的流，哪怕你只读 stdout，也得手动 fclose($pipes[0])（stdin），否则命令可能等不到 EOF 就一直挂起。
实操建议：
- 无论是否使用某条管道，只要
$pipes数组里对应索引存在，就fclose()它 - 顺序很重要：先关
$pipes[0]（stdin），再读$pipes[1]（stdout），最后关$pipes[2]（stderr） - 务必用
proc_get_status($proc)['running']判断是否已退出，不能仅靠fread返回空就认为结束
多管道 proc_open 的最小可靠写法（PHP7.2 兼容）
以下代码能稳定执行 ls -la /tmp 并分别捕获 stdout/stderr，适用于 PHP7.2+，不含异常处理但逻辑完整：
$desc = [
0 => ['pipe', 'r'], // stdin
1 => ['pipe', 'w'], // stdout
2 => ['pipe', 'w'], // stderr
];
$proc = proc_open('ls -la /tmp', $desc, $pipes);
if (!is_resource($proc)) {
die('proc_open failed');
}
// 关闭 stdin —— 必做，否则 ls 可能阻塞
fclose($pipes[0]);
// 读 stdout
$stdout = stream_get_contents($pipes[1]);
fclose($pipes[1]);
// 读 stderr
$stderr = stream_get_contents($pipes[2]);
fclose($pipes[2]);
// 等待进程结束并获取状态
proc_close($proc);
echo "stdout:\n$stdout\n";
echo "stderr:\n$stderr\n";
常见错误：stream_get_contents 阻塞或返回空
现象是脚本卡在 stream_get_contents($pipes[1])，或返回空字符串但实际命令有输出。根本原因不是函数问题，而是管道没关、进程没退出、或缓冲区未刷新。
立即学习“PHP免费学习笔记（深入）”；
排查要点：
- 确认已
fclose($pipes[0])—— 最常被忽略的一步 - 检查命令本身是否交互式（如
cat、vim），非交互命令才适合这种模式 - 避免用
fgets()循环读取，PHP7.2 的管道流不支持行阻塞等待；改用stream_get_contents()或带超时的stream_select() - 若需实时读取（比如 tail -f），必须配合
stream_set_blocking($pipes[1], false)和轮询
proc_close 和 return_code 的坑
proc_close() 会阻塞直到子进程终止，并返回其 exit code；但它**不保证**你已经读完所有输出——如果 stdout/stderr 还没读完就调 proc_close()，剩余数据会丢失。
正确顺序只能是：
- 关闭 stdin（
$pipes[0]） - 用
stream_get_contents()读完$pipes[1]和$pipes[2] - 再
fclose()这两个 pipe - 最后调
proc_close()
另外注意：proc_get_status($proc)['exitcode'] 在 proc_close() 前就可读，但该值只有进程真正退出后才有效；如果进程还在跑，这个字段可能是 -1 或未定义。
