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 文件可能被加载，最终值以实际运行时为准。
在你的上传处理脚本开头加这段诊断代码：
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
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 的上传错误。
