要实现PHP实时输出，需配置PHP关闭缓冲并刷新输出，同时在Nginx中禁用fastcgi_buffering，并确保无其他代理层缓存。1. PHP中设置output_buffering=off、implicit_flush=true，使用flush()；2. Nginx配置fastcgi_buffering off；3. 检查CDN、浏览器等中间层影响；4. 通过curl验证逐行输出效果。
PHP 实时输出常用于需要即时反馈的场景，比如长时间运行的任务、进度条或日志流。但即便 PHP 开启了输出缓冲控制，Nginx 作为反向代理可能会缓存响应内容，导致浏览器无法实时接收数据。要实现真正意义上的“实时输出”，必须同时配置 PHP 和 Nginx 禁用缓冲。
1. 确保 PHP 正确设置输出缓冲
在 PHP 脚本中，需主动关闭输出缓冲并强制刷新输出内容：
- 关闭输出缓冲：使用 ob_end_flush() 或确保没有开启 ob_start()
- 启用隐式刷新：ini_set('implicit_flush', true);
- 发送必要的 HTTP 头：告知浏览器内容是流式传输
header('X-Accel-Buffering: no'); // 告诉 Nginx 不要缓冲
ini_set('output_buffering', 'off');
ini_set('zlib.output_compression', false);
ini_set('implicit_flush', true);
ob_implicit_flush(true);
for ($i = 0; $i echo "第 {$i} 条消息\n";
flush(); // 尝试刷新 PHP 输出缓冲
sleep(1);
}
2. 配置 Nginx 禁用代理缓冲
Nginx 默认会对代理请求启用缓冲（proxy_buffering），这会收集后端响应直到缓冲区满或请求结束才发送给客户端，从而阻断实时输出。必须在 server 或 location 块中显式关闭：
location ~ \.php$ {include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
# 关键配置：禁用缓冲
proxy_buffering off;
fastcgi_buffering off;
fastcgi_request_buffering off;
# 可选：设置超时时间适应长任务
fastcgi_read_timeout 300;
}
说明：
fastcgi_buffering off; 是关键，它禁止 Nginx 缓存 FastCGI 响应。
proxy_buffering off; 在使用 proxy_pass 时有效，若直接与 PHP-FPM 通信可省略，但加上无害。
X-Accel-Buffering: no 响应头也能动态控制 Nginx 缓冲行为，优先级高于配置。
立即学习“PHP免费学习笔记（深入）”；
3. 检查服务器环境其他可能的缓冲层
除了 PHP 和 Nginx，还需注意：
- CDN 或反向代理：如 Cloudflare、AWS ALB 等可能自带缓冲，需单独关闭或绕过
- 浏览器：部分浏览器对小响应有渲染延迟，建议每次输出足够字符（如加多个空格或换行）触发显示
- PHP SAPI 层：CLI 模式下行为不同，FPM 模式需确认配置未覆盖 buffering 设置
4. 验证实时输出是否生效
执行脚本后，观察浏览器是否逐行显示内容，而非等待全部完成。可用 curl 测试：
curl http://yoursite.com/stream.php如果看到逐行输出，则说明配置成功；若仍延迟，则检查 Nginx 错误日志和实际生效的配置文件。
基本上就这些。关键是 PHP 主动刷新 + Nginx 禁用缓冲，再排除外部中间件影响，就能实现稳定实时输出。
