直接改 client_max_body_size 就行,因 phpEnv 底层用 Nginx,默认限制 1MB,即使调高 PHP 的 upload_max_filesize 和 post_max_size,Nginx 仍会在请求到达前返回 413 错误;需在 phpenv/nginx/conf/vhosts/ 对应站点 conf 的 location 块中添加 client_max_body_size 100m;,并同步修改 php.ini 中 upload_max_filesize = 100M 和 post_max_size = 100M,最后重启 Nginx 与 PHP-FPM。

直接改 client_max_body_size 就行,phpEnv 本身不控制这个值,它只是个集成环境套件,底层还是 Nginx + PHP,真正拦住大文件上传的是 Nginx 的默认限制(1MB)。
为什么 phpEnv 下上传文件总卡在 1MB?
phpEnv 默认使用 Nginx 作为 Web 服务器,而 Nginx 的 client_max_body_size 默认是 1m。哪怕你调高了 PHP 的 upload_max_filesize 和 post_max_size,Nginx 也会在请求到达 PHP 前就返回 413 错误。
常见表现:
- 前端上传 2MB 文件时,Network 面板显示
413 Request Entity Too Large - phpEnv 控制面板里改了 PHP 设置,但问题依旧
- 错误日志(
logs/nginx/error.log)里出现client intended to send too large body
在哪改 client_max_body_size?优先 location 级别
phpEnv 的 Nginx 配置通常放在 phpenv/nginx/conf/vhosts/ 下,每个站点一个 conf 文件(如 default.conf)。不要去动全局 nginx.conf,避免影响其他站点。
立即学习“PHP免费学习笔记(深入)”;
推荐写法(加在对应 server 块里的 location ~ \.php$ 或专门的上传路由里):
location /upload {
client_max_body_size 100m;
include fastcgi_params;
fastcgi_pass 127.0.0.1:9000;
}
注意点:
-
client_max_body_size必须带单位(m、g),不能写数字不带单位 - 写在
location里比写在server或http更精准,只放行指定路径 - 如果用了反向代理(比如转发到后端 PHP-FPM),确保该
location块里也包含include fastcgi_params等必要指令
PHP 层也要同步调大,否则会 500 或静默失败
Nginx 放行之后,PHP 还有两道关卡:upload_max_filesize 和 post_max_size。它们在 phpEnv 的 php/php.ini 里(路径类似 phpenv/php/8.2.0/etc/php.ini)。
必须同时修改这两项(单位统一用 M):
upload_max_filesize = 100M-
post_max_size = 100M(注意:它必须 ≥upload_max_filesize)
改完后重启 phpEnv 的 Nginx 和 PHP 服务(用控制面板或命令行):
phpenv/nginx/bin/nginx -s reload phpenv/php/8.2.0/bin/php-fpm -R
验证是否生效的最简方式
别等前端上传,用 curl 直接测:
curl -X POST http://localhost/upload \ -F "file=@large-file.zip" \ -v
如果返回 200 或你的业务响应,说明通了;如果还是 413,检查:
- 是否改的是正在运行的配置文件(有些 phpEnv 版本会生成临时 conf)
- 是否漏写了分号(
client_max_body_size 100m;——;不可少) - 是否重启了 Nginx(
-s reload比全停更安全) - PHP-FPM 是否真加载了新
php.ini(访问phpinfo()页面确认)
最容易被忽略的是:phpEnv 启动脚本有时会覆盖用户修改的配置,建议把关键设置(如 client_max_body_size)加到 vhosts 下的站点 conf 里,并用 nginx -t 先校验语法。



















