PHP无法实时输出后台任务进度，因exec/system等函数阻塞等待进程结束；需用proc_open配合非阻塞读取、ob_flush/flush、服务端流式响应头及前端EventSource或fetch流式API，并调优Web服务器超时与禁用缓冲。
PHP 本身不支持真正的“后台任务实时输出”——exec、shell_exec 等函数默认会阻塞，直到命令结束才返回全部输出。想看到进度，得绕过缓冲、禁用输出压缩、处理 HTTP 连接保持，还要小心超时和内存泄漏。
为什么 exec() 和 system() 看不到实时输出
这些函数内部会等待子进程完全退出，再一次性把 stdout/stderr 返回为字符串。即使被调用的脚本每秒 echo "progress: 10%"; flush();，PHP 也不会在执行中吐出内容。
- Web 服务器（如 Nginx）通常会缓冲响应体，直到收到完整响应或超时
- PHP 的
output_buffering默认开启，flush()无效 - 浏览器也可能延迟渲染小块响应，尤其没遇到换行或足够字节数时
用 proc_open() 捕获实时 stdout
这是最可控的方式：手动创建进程、打开管道、边读边输出。关键在于非阻塞读取 + 及时 flush()。
示例片段（简化版）：
立即学习“PHP免费学习笔记（深入）”；
$descriptors = [
0 => ['pipe', 'r'], // stdin
1 => ['pipe', 'w'], // stdout ← 我们要读它
2 => ['pipe', 'w'], // stderr（可选）
];
$process = proc_open('php long_task.php', $descriptors, $pipes);
if (is_resource($process)) {
stream_set_blocking($pipes[1], false); // 关键：设为非阻塞
while (true) {
$line = fgets($pipes[1]);
if ($line !== false && $line !== '') {
echo $line;
@ob_flush();
flush(); // 强制推送
}
if (proc_get_status($process)['running'] === false) break;
usleep(10000); // 10ms 间隔，避免空转
}
proc_close($process);
}
- 必须用
stream_set_blocking($pipes[1], false)，否则fgets()会卡住 -
@ob_flush()是为了清 PHP 输出缓冲层；flush()推给 Web 服务器 - 别在循环里做耗时操作（如数据库写入），否则会拖慢输出节奏
前端配合：用 EventSource 或流式 fetch 接收
直接输出到 HTML body 容易乱码或被浏览器截断。更健壮的做法是后端输出纯文本流，前端用流式 API 解析。
- 服务端响应头必须包含：
Content-Type: text/event-stream或text/plain，且禁用缓存：Cache-Control: no-cache - 前端用
EventSource最省事（但只支持 GET）；若需 POST，改用fetch().then(res => res.body.getReader())+ReadableStream - 每次输出建议以换行结尾（
\n），便于前端按行解析；大段内容可加前缀如data:（适配 SSE）
绕不开的坑：超时、内存、连接中断
这类长连接极易触发各种超时，不是写对 PHP 就完事。
- Nginx 默认
fastcgi_read_timeout 60，需调大；Apache 有TimeOut和ProxyTimeout - PHP
max_execution_time必须设为 0（不限时），但注意 CLI 模式下该设置无效，Web 模式下才生效 - 用户刷新或关闭页面时，PHP 进程不会自动终止——要用
connection_aborted()或心跳检测主动退出 - 不要在循环里累积字符串（如
$log .= $line），内存会线性增长；直接echo+flush即可
真正难的不是“怎么让 PHP 吐出来”，而是“怎么让整条链路（PHP → Web Server → 浏览器 → JS）都愿意等、不截断、不重置”。每个环节都可能悄悄吞掉你的 flush()。
