PHP多文件上传实现方法详解

本文深入解析了PHP多文件上传的核心机制与实战要点，揭示了$_FILES数组在name属性含“[]”时自动生成二维结构的关键规律，并强调前端表单必须设置enctype="multipart/form-data"、后端须同步索引遍历各子数组以避免文件信息错配；同时直击常见失败根源——php.ini中upload_max_filesize、post_max_size和max_file_uploads三者的协同限制，以及后端必须进行的MIME类型校验、文件名清洗和临时目录空间检查等安全与健壮性措施，帮助开发者跳出var_dump迷惑、绕过静默丢弃陷阱，真正实现稳定可靠的多文件上传功能。

PHP $_FILES 多文件上传的结构怎么读？

PHP 本身不区分单/多文件上传，关键在前端 <input type="file" multiple> 和后端对 $_FILES 数组结构的理解。很多人卡在第一步：用 var_dump($_FILES) 看到一堆嵌套数组就懵了——这其实是 PHP 把多个文件按字段名“归组”后的标准格式。

• 如果表单字段是 name="photos[]"，$_FILES['photos'] 是一个二维数组，含 name、tmp_name、error 等键，每个键下才是对应文件的值列表
• 如果字段是 name="photo"（没加 []），即使加了 multiple，PHP 也只保留最后一个文件，其余被覆盖
• $_FILES 的 error 值为 UPLOAD_ERR_OK 才表示该文件上传成功，其他值（如 UPLOAD_ERR_INI_SIZE）需单独检查

循环处理 $_FILES 多文件时怎么避免漏错？

直接 foreach $_FILES['files']['name'] 是常见写法，但必须同步索引检查其他子数组，否则会把不同文件的 name 和 tmp_name 错配。

$files = $_FILES['photos'];
for ($i = 0; $i 

• 别用 foreach ($files['name'] as $name) 单独遍历，丢失索引后无法关联 tmp_name 和 error
• move_uploaded_file() 必须传 $files['tmp_name'][$i]，不是 $tmp 变量名本身
• 每次循环都要检查 $files['error'][$i]，上传中断或用户取消会导致部分项为非零错误码

为什么上传大文件或多个文件总失败？

根本原因不在 PHP 代码，而在 php.ini 的三处限制：

• upload_max_filesize 控制单个文件上限（如 10M）

• post_max_size 必须 ≥ 所有文件大小之和 + 表单其他字段体积，否则整个 POST 被截断，$_FILES 为空

• max_file_uploads 限制单次请求最多允许几个文件（默认 20），超数的文件会被静默丢弃，$_FILES 里根本不会出现

• 修改后必须重启 Web 服务器（如 Apache 或 PHP-FPM），仅 reload 不生效

• 开发时可用 ini_get('upload_max_filesize') 动态确认当前值，别只信配置文件注释

前端 enctype 和后端校验怎么做才不白忙？