PHP多文件上传失败主因是$_FILES结构误读、服务端限制未调、表单属性遗漏；其为按字段分组的转置二维数组，需用count($_FILES'files')获文件数再for循环索引处理。
PHP 多文件上传出错，通常不是代码写错了，而是 $_FILES 结构没理解清楚、服务端限制没调对，或者前端表单属性漏了——先确认这三点，90% 的问题当场解决。
为什么 $_FILES 是二维数组却拿不到多个文件？
HTML 表单中多个同名 <input type="file" name="files[]"> 提交后，$_FILES['files'] 不是按文件索引排列的扁平数组，而是按字段键分组的「转置结构」：
Array(
'name' => ['a.jpg', 'b.pdf'],
'type' => ['image/jpeg', 'application/pdf'],
'tmp_name' => ['/tmp/phpabc123', '/tmp/phpdef456'],
'error' => [0, 0],
'size' => [102400, 204800]
)
直接 foreach ($_FILES['files'] as $file) 会遍历每个字段（比如所有 name），而不是每个文件。正确做法是用索引对齐：
- 用
count($_FILES['files']['name'])获取文件数 - 再用
for ($i = 0; $i 遍历，取 <code>$_FILES['files']['name'][$i]、['tmp_name'][$i]等 - 务必检查
$_FILES['files']['error'][$i] === UPLOAD_ERR_OK，不能只看tmp_name是否非空
upload_max_filesize 和 post_max_size 哪个更关键？
两者都必须同时满足，且单位一致（如都设为 20M）。常见错误是只改了 upload_max_filesize，结果多文件总大小超了 post_max_size，导致整个 $_POST 和 $_FILES 为空——这时 $_FILES 直接是空数组，连 error 都不会报。
立即学习“PHP免费学习笔记（深入）”；
- 查当前值：运行
phpinfo()或ini_get('upload_max_filesize')、ini_get('post_max_size') - 修改位置：优先改项目级
.htaccess（Apache）或php.ini（CLI/FPM），ini_set()在运行时无效 - 注意单位：
20M有效，20MB会被忽略（PHP 只认 K/M/G）
调试时 $_FILES 显示 error = 4 怎么办？
UPLOAD_ERR_NO_FILE（即 4）表面是“没选文件”，但多文件场景下，它常因前端未正确设置 enctype="multipart/form-data" 或 JS 动态提交时漏传某个 input 导致——浏览器根本没把那个字段发过来。
- 用浏览器 DevTools 的 Network → FormData 标签页，确认每个
files[]字段是否真实存在并带文件名 - 如果用 JS 构造
FormData，确保是formData.append('files[]', file)，而不是append('files', file)（后者服务端收不到数组） - 检查是否有隐藏的
input type="file"被清空但仍在 DOM 中，PHP 仍会为其生成一个error=4条目
为什么本地能传、线上 500 且日志里没报错？
很可能是线上环境启用了 mod_security 或 WAF（如 Cloudflare），拦截了 multipart 请求体中的某些文件名、类型或边界符（boundary）。这类拦截不进 PHP，所以 error_log 无记录，Nginx/Apache 错误日志里也只显示 “client closed connection” 或空 500。
- 临时关闭 WAF 测试；或让运维查 ModSecurity 日志（路径类似
/var/log/modsec_audit.log） - 简化测试：上传一个纯英文名、无空格无特殊字符的
.txt文件，排除文件名/类型黑名单问题 - 检查
max_input_time和max_execution_time，大文件上传中途超时也会静默失败
多文件上传真正麻烦的从来不是循环逻辑，而是边界条件：空数组、部分失败、WAF 干预、配置层级覆盖。调试时别急着改 PHP 代码，先盯死 $_FILES 结构、HTTP 请求体、PHP 配置三者的实时状态。
