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

PHP上传文件超限的典型错误现象
当你尝试上传大于默认限制的文件时,$_FILES 数组中对应项的 error 值会是 1(UPLOAD_ERR_INI_SIZE),且 size 为 0。这不是前端拦截或网络中断,而是 PHP 在解析请求体前就根据 upload_max_filesize 直接拒绝了整个文件上传——连 $_POST 都可能为空。
必须同时修改的两个 ini 配置项
只改 upload_max_filesize 不起作用。PHP 还受 post_max_size 约束:它限制整个 POST 请求体(含文件 + 表单字段)的总大小。若 post_max_size 小于 upload_max_filesize,仍会失败,且错误码可能是 UPLOAD_ERR_FORM_SIZE(error = 2)。
修改建议如下:
-
upload_max_filesize = 50M(按需设,单位支持M、G) -
post_max_size = 52M(务必比upload_max_filesize大一点,预留表单字段空间)
注意:这两个值在 php.ini 中定义,重启 Web 服务(如 nginx + php-fpm)后才生效;用 .htaccess 或 ini_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_size 是 1m,Apache 的 LimitRequestBody 默认可能为 0(无限制),但也常被显式设小。
Nginx 示例(在 server 或 location 块中):
client_max_body_size 64M;
Apache 示例(.htaccess 或虚拟主机配置):
LimitRequestBody 67108864
单位是字节,64M = 67108864。改完 Nginx 要 nginx -t && nginx -s reload,Apache 要重启服务。
最容易被忽略的是:Nginx 的 fastcgi_read_timeout 和 proxy_read_timeout(如果用了反向代理),上传时间长时也会触发 504 错误,而非 PHP 的上传错误。











