phpEnv 下 PHP 接口无法流式传输，根本原因是 Nginx 的 fastcgi_buffering 默认开启且 PHP 输出缓冲未关闭；需同时配置 Nginx 的 fastcgi_buffering off 和 PHP 中 ob_end_clean() 或循环 ob_end_flush()。
phpEnv 默认不支持流式传输，关键在于 Nginx 配置未禁用代理缓冲，且后端 PHP 未关闭输出缓冲 —— 单独改 chunked_transfer_encoding off 反而会破坏流式，这是最常见的误操作。
为什么 phpEnv 下的 PHP 接口返回数据总是一次性吐完？
phpEnv 套件默认使用 Nginx + PHP-FPM 模式，Nginx 在 proxy_pass 到 PHP-FPM 时走的是 FastCGI 协议，不是 HTTP 代理。这意味着：
-
proxy_buffering、proxy_http_version这类 HTTP 代理指令完全不生效 -
chunked_transfer_encoding控制的是 Nginx 自身作为 origin server 的行为（比如 static 文件或 error_page），对 FastCGI 后端无效 - 真正卡住流式的，是 PHP-FPM 的
buffer行为 + Nginx 的fastcgi_buffering（默认开启）
必须关掉的两个缓冲层：Nginx fastcgi_buffering 和 PHP 输出缓冲
要让 echo 或 yield 真正“边生成边发”，需同时解除两层缓冲：
- 在 Nginx location 块中添加：
fastcgi_buffering off;（注意不是proxy_buffering） - 在 PHP 脚本开头强制关闭输出缓冲：
ob_end_clean();或while (@ob_end_flush()); - PHP-FPM pool 配置中确认未设置
php_flag[output_buffering] = On（检查www.conf） - 若用
readfile()或fpassthru()，确保文件打开模式为'rb'，并配合flush()和ob_flush()
典型 SSE / 日志流配置示例（phpEnv 环境）
假设你用 PHP 输出 Server-Sent Events，在 location ~ \.php$ 或具体路径下配：
立即学习“PHP免费学习笔记（深入）”；
location /events.php {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi.conf;
fastcgi_buffering off;
# 关键：告诉客户端这是流式响应
add_header Content-Type "text/event-stream";
add_header Cache-Control "no-cache";
# 防止 Nginx 或浏览器缓存响应体
add_header X-Accel-Buffering "no";
}对应 PHP 脚本需包含：
<?php
ob_end_clean();
header('Content-Type: text/event-stream');
header('Cache-Control: no-cache');
header('X-Accel-Buffering: no');
<p>while (true) {
echo "data: " . date('Y-m-d H:i:s') . "\n\n";
ob_flush();
flush();
sleep(1);
}容易被忽略的致命细节
即使上面都配对了，仍可能失败：
- Chrome/Firefox 会等待至少 2KB 数据才触发
message事件 —— 在首条消息前加 2KB 空格或注释可绕过 - phpEnv 中的 Nginx 版本若低于 1.11.6，
fastcgi_buffering指令不可用，只能降级用fastcgi_max_temp_file_size 0;+ 提高fastcgi_buffers数量来“模拟”流式（不推荐） - 某些 phpEnv 安装包默认启用
gzip on，而 gzip 会强制缓冲整个响应 —— 流式接口 location 必须加gzip off; - FastCGI 协议本身不携带
Transfer-Encoding，所以响应头里看不到chunked—— 不代表没流式，用curl -N观察是否持续收到数据即可验证
