应使用 proc_open() 配合非阻塞流读取实现 PHP 实时捕获并输出 stdout，核心是设置 stdout 为管道、调用 stream_set_blocking($stdout, false)，逐行 fgets() 读取并及时 flush，同时注意跨平台换行符和缓冲链路各环节（PHP/FPM/Nginx/浏览器）的缓冲配置。
PHP 执行系统命令时如何实时捕获并输出 stdout
PHP 默认会等 exec()、shell_exec() 等函数执行完才返回全部输出，没法看到命令运行中的实时日志。要实现“边跑边打”，核心是绕过缓冲、逐行读取、禁用输出缓存。
最可靠的方式是用 proc_open() 配合非阻塞流读取，而不是依赖 system() 或 passthru()（它们虽能直接输出，但无法拦截或加工内容）。
- 必须设置
stdout为管道（pipe），不能直接继承STDIN/STDOUT - 调用
stream_set_blocking($stdout, false)，否则fgets()会卡住 - 需手动调用
ob_flush()+flush()（且 Web 服务器需支持，CLI 下无需） - Windows 下注意换行符可能是
\r\n，用rtrim($line, "\r\n")更稳妥
为什么 exec("xxx 2>&1", $out) 不行
这种写法把整个命令当黑盒执行，$out 是执行完毕后一次性返回的数组，完全不满足“实时”要求。哪怕命令跑 5 分钟，你也得等到最后才看到第一行。
更隐蔽的问题是：某些命令（如 ping、composer install、ffmpeg）在被 PHP 子进程调用时，会检测是否连接到终端（tty），自动开启行缓冲甚至全缓冲——导致明明有输出，PHP 却迟迟读不到。
立即学习“PHP免费学习笔记（深入）”；
在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……
-
stdbuf -oL -eL command可强制行缓冲（Linux/macOS 有效） - Windows 没
stdbuf，可用winpty或改用 PowerShell 的Start-Process -RedirectStandardOutput（但复杂度陡增） - 部分命令自带无缓冲选项，例如
curl --no-buffer、python -u script.py
一个可直接用的 CLI 实时执行函数
以下函数适用于 PHP CLI 环境（Web 环境需额外处理输出缓冲和超时）：
function runCommandRealtime($cmd) {
$descriptors = [
0 => ['pipe', 'r'], // stdin
1 => ['pipe', 'w'], // stdout
2 => ['pipe', 'w'] // stderr
];
$process = proc_open($cmd, $descriptors, $pipes);
if (!is_resource($process)) return false;
stream_set_blocking($pipes[1], false);
stream_set_blocking($pipes[2], false);
while (true) {
$line = fgets($pipes[1]);
if ($line !== false) echo rtrim($line, "\r\n") . "\n";
$err = fgets($pipes[2]);
if ($err !== false) fwrite(STDERR, rtrim($err, "\r\n") . "\n");
$status = proc_get_status($process);
if (!$status['running']) break;
usleep(10000); // 10ms 间隔，避免空转耗 CPU
}
$returnCode = proc_close($process);
return $returnCode === 0;
}
调用示例：runCommandRealtime("ping -c 5 google.com") 或 runCommandRealtime("php long_script.php")。
注意：proc_open() 在共享主机或某些 Docker 容器里可能被禁用，先检查 disable_functions 配置。
Web 环境下实时输出的额外限制
即使 PHP 层做到了逐行读取，浏览器也不一定立刻渲染——因为 HTTP 是响应流，中间件（如 Nginx 的 fastcgi_buffering on）、PHP-FPM 的 buffer_output = On、甚至浏览器自身都会攒包。
- Nginx 必须关掉缓冲：
fastcgi_buffering off;（或设fastcgi_max_temp_file_size 0;） - PHP-FPM 中确保
php_admin_value[output_buffering] = Off - 脚本开头加
ignore_user_abort(true); set_time_limit(0);防止超时中断 - 每输出一行后，务必调用
ob_flush(); flush();（顺序不能反）
真正难的不是 PHP 怎么读，而是整条链路（PHP → FPM → Web Server → Browser）每一环都得配对放开缓冲——漏一环就卡住不动。
