PHP接收文件大小超过限制怎么办_修改uploadmaxfilesize设置技巧【说明】

PHP上传超限错误码为1(UPLOAD_ERR_INI_SIZE),因upload_max_filesize和post_max_size共同限制,且需同步修改Nginx的client_max_body_size等配置。

PHP上传文件超限的典型错误现象

当你尝试上传大于默认限制的文件时,$_FILES 数组中对应项的 error 值会是 1UPLOAD_ERR_INI_SIZE),且 size0。这不是前端拦截或网络中断,而是 PHP 在解析请求体前就根据 upload_max_filesize 直接拒绝了整个文件上传——连 $_POST 都可能为空。

必须同时修改的两个 ini 配置项

只改 upload_max_filesize 不起作用。PHP 还受 post_max_size 约束:它限制整个 POST 请求体(含文件 + 表单字段)的总大小。若 post_max_size 小于 upload_max_filesize,仍会失败,且错误码可能是 UPLOAD_ERR_FORM_SIZEerror = 2)。

修改建议如下:

  • upload_max_filesize = 50M(按需设,单位支持 MG
  • post_max_size = 52M(务必比 upload_max_filesize 大一点,预留表单字段空间)

注意:这两个值在 php.ini 中定义,重启 Web 服务(如 nginx + php-fpm)后才生效;用 .htaccessini_set() 无法修改它们。

立即学习“PHP免费学习笔记(深入)”;

如何确认当前生效的配置值

别依赖 phpinfo() 页面里显示的“Loaded Configuration File”路径去猜——多个 ini 文件可能被加载,最终值以实际运行时为准。

在你的上传处理脚本开头加这段诊断代码:

echo "upload_max_filesize: " . ini_get('upload_max_filesize') . "\n";
echo "post_max_size: " . ini_get('post_max_size') . "\n";
echo "max_execution_time: " . ini_get('max_execution_time') . "\n";
echo "memory_limit: " . ini_get('memory_limit') . "\n";

常见干扰项:

  • max_execution_time:大文件上传耗时长,超时会导致连接中断,建议调高(如 300
  • memory_limit:PHP 读取/处理大文件时可能内存溢出,尤其用 file_get_contents() 一次性加载,应改用流式处理

Web 服务器层的隐性限制(Nginx / Apache)

即使 PHP 配置全放开,Nginx 默认 client_max_body_size1m,Apache 的 LimitRequestBody 默认可能为 0(无限制),但也常被显式设小。

Nginx 示例(在 serverlocation 块中):

client_max_body_size 64M;

Apache 示例(.htaccess 或虚拟主机配置):

LimitRequestBody 67108864

单位是字节,64M = 67108864。改完 Nginx 要 nginx -t && nginx -s reload,Apache 要重启服务。

最容易被忽略的是:Nginx 的 fastcgi_read_timeoutproxy_read_timeout(如果用了反向代理),上传时间长时也会触发 504 错误,而非 PHP 的上传错误。