PHP 上传大文件报 POST Content-Length exceeds the limit 怎么改

现象:小文件能传,大文件直接失败

后台上传几十兆的视频或压缩包,页面提示 POST Content-Length of 33554432 bytes exceeds the limit of 8388608 bytes,表单里的其他字段也一起丢失。传几百 KB 的图片却完全正常。

原因:三道限制,任何一道都会截断请求

  • PHP 的 post_max_size 限制整个 POST 包体,超过后 $_POST 和 $_FILES 会直接为空;
  • PHP 的 upload_max_filesize 只管单个文件,通常比 post_max_size 小;
  • Nginx 的 CLIent_max_body_size 默认只有 1M,超了直接回 413,请求根本进不到 PHP。

解决步骤

第一步,把 PHP 两个值一起调大,post_max_size 必须大于 upload_max_filesize:

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 300

第二步,同步 Nginx 限制,放在 server 或 location 块里:

client_max_body_size 64m;

第三步,重启生效。只 reload Nginx 不够,PHP-FPM 也需要重载才能读到新 ini:

php -i | grep -E "post_max_size|upload_max"
systemctl reload php-fpm nginx

第四步,确认改的是正在用的 ini。CLI 和 FPM 的配置文件常常不是同一个,用 php --ini 看命令行,用页面里的 phpinfo() 看 FPM 实际加载路径,改错文件重启也没用。

如果用的是宝塔或容器,面板里还有一层上传限制,改完配置记得在面板设置里同步。

另外一个容易踩的坑:post_max_size 触发时,PHP 不会抛异常,只是把 $_POST 和 $_FILES 清空。如果业务代码里有 CSRF 校验,你会看到"令牌无效"这种看似无关的报错,而不是上传失败。排查时先看 Nginx 的 error.log 有没有 413,再看 PHP 的 error_log 里有没有 Content-Length 的 warning,两条日志就能定位是哪一层截断的。

小结

先看报错类型:出现 413 是 Nginx 拦的,出现 Content-Length 提示是 PHP 拦的。两层都改到位,再确认配置文件路径正确。

您可以还会对下面的文章感兴趣: