PHP多文件上传错误排查指南

文章不知道大家是否熟悉？今天我将给大家介绍《PHP多文件上传错误排查教程》，这篇文章主要会讲到等等知识点，如果你在看完本篇文章后，有更好的建议或者发现哪里有问题，希望大家都能积极评论指出，谢谢！希望我们能一起加油进步！

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 遍历，取 $_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 都不会报。

• 查当前值：运行 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 配置三者的实时状态。

本篇关于《PHP多文件上传错误排查指南》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！