需修改client_max_body_size、client_body_buffer_size、proxy_buffering相关参数:前者设上传上限(如100m),后者匹配设256k~1m避免落盘,proxy_buffering保持on时须同步调大proxy_buffers和proxy_busy_buffers_size;若需PHP实时输出则设proxy_buffering off并配proxy_buffer_size 4k。

phpEnv里改Nginx缓冲区要动哪几个配置项
phpEnv本身不直接管理Nginx参数,它只是把Nginx配置文件(通常是 nginx.conf 或站点 conf 文件)封装进图形界面。真正起作用的是你手动编辑的配置块。重点改这三组:client_max_body_size、client_body_buffer_size、proxy_buffering 相关参数——它们分别管上传上限、上传缓存、代理响应缓存。
常见错误是只调大 client_max_body_size,却忽略 client_body_buffer_size 过小导致上传中途被写入临时文件,反而增加IO开销甚至超时中断。
-
client_max_body_size设为你要支持的最大单文件上传大小,比如100m;别设成0(禁用限制),否则可能被恶意请求拖垮 -
client_body_buffer_size建议设为256k~1m,和client_max_body_size匹配:若上传多为 10MB 文件,256k就够;若常传 50MB+ 视频,可提到1m避免频繁落盘 - PHP-FPM 作为后端时,
proxy_buffering建议保持on,但必须同步调大proxy_buffers(如8 128k)和proxy_busy_buffers_size(如256k),否则大响应体容易卡在缓冲区不动
大文件下载中断不是PHP内存问题,而是Nginx截断了流
很多用户看到“PHP内存溢出”就去改 memory_limit,结果没用——因为中断往往发生在 Nginx 层:它默认启用 proxy_buffering on,会把 PHP 输出的内容先攒满缓冲区再发给客户端。一旦文件大、网速慢或客户端暂停,Nginx 可能主动关闭连接,报错日志里常出现 upstream prematurely closed connection。
根本解法不是让 PHP 更“省内存”,而是让 Nginx 少“拦路”。关键动作是绕过它的缓冲逻辑:
立即学习“PHP免费学习笔记(深入)”;
- 在对应站点的
location ~ \.php$块里加:proxy_buffering off; - 同时必须显式设置
proxy_buffer_size 4k;(仅用于响应头,不能省) - 如果用了
fastcgi_pass而非proxy_pass,则对应换为:fastcgi_buffering off;和fastcgi_buffer_size 4k; - 确认 PHP 脚本本身已用
fopen+fpassthru流式输出,并设置了header('X-Accel-Buffering: no');(防止 Nginx 忽略buffering off指令)
phpEnv界面改完不生效?检查这三个地方
phpEnv 的“应用配置”按钮有时只重载部分进程,或漏掉子配置文件。改完缓冲区后仍中断,优先排查:
- 是否修改的是全局
nginx.conf,但站点实际加载的是vhosts/xxx.conf?后者里的同名指令会覆盖前者 - phpEnv 自带的 Nginx 版本是否太旧(如 1.16 以下)?
proxy_buffering off在老版本中对 FastCGI 支持不稳定,建议升级到 1.20+ - Windows 下 phpEnv 默认用的是 Windows 版 Nginx,其 socket 缓冲行为和 Linux 不同,
client_body_timeout和send_timeout得同步调大(如都设为300s),否则空闲传输易被断连
HTTP Range 断点续传必须由PHP自己处理
Nginx 不会自动帮你实现断点续传——即使你开了 Accept-Ranges: bytes,那也只是告诉浏览器“我支持”,具体怎么切片、怎么读偏移、怎么回 206 Partial Content,全得 PHP 自己写逻辑。phpEnv 环境下尤其要注意:
- 确保 PHP 脚本开头有
ignore_user_abort(true);,否则客户端暂停时 PHP 进程可能直接退出 - 用
$_SERVER['HTTP_RANGE']解析字节范围,再用fseek($fp, $start)定位,千万别用file_get_contents加 offset 参数,它会把整个文件读进内存 - 别依赖 Nginx 的
slice模块(需编译支持且 phpEnv 通常未开启),它只适用于静态文件,对 PHP 动态生成的下载无效 - 如果用 x-sendfile,phpEnv 默认不启用,需手动在 Nginx 配置里加
location /protected/ { internal; }并在 PHP 中 headerX-Sendfile,但 Windows 下基本不可用
最稳的方式还是 PHP 自己流式读 + 正确发 Range 响应头。缓冲区调得再大,也救不了没处理 HTTP 协议层逻辑的脚本。



















