PHP实时输出CMD命令执行结果

大家好，今天本人给大家带来文章《PHP实时输出CMD命令行结果方法》，文中内容主要涉及到，如果你对文章方面的知识点感兴趣，那就请各位朋友继续看下去吧~希望能真正帮到你们，谢谢！

应使用 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 却迟迟读不到。

• 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）每一环都得配对放开缓冲——漏一环就卡住不动。

今天关于《PHP实时输出CMD命令执行结果》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！