PHP需用自定义函数展平$_FILES['photos']嵌套结构，再逐个检查error是否为UPLOAD_ERR_OK，匹配前端name="docs[]"并调高upload_max_filesize和max_file_uploads。
PHP如何正确接收 $_FILES 中的多文件数组
PHP 默认不会自动把多个同名文件输入框（<input type="file" name="photos[]" multiple>）解析成扁平数组，而是生成嵌套结构。直接遍历 $_FILES['photos'] 会出错，因为它的键是 name、tmp_name 等，不是按文件索引组织的。
关键点：必须先用自定义函数“展平”$_FILES['photos']，否则 foreach 会遍历出字段名而非文件项。
推荐写法：
function flatten_files_array($files) {
$flattened = [];
foreach ($files['name'] as $index => $name) {
if (!empty($name)) {
$flattened[] = [
'name' => $name,
'type' => $files['type'][$index],
'tmp_name' => $files['tmp_name'][$index],
'error' => $files['error'][$index],
'size' => $files['size'][$index],
];
}
}
return $flattened;
}
$uploaded_files = flatten_files_array($_FILES['photos']);
move_uploaded_file() 批量处理前必须检查每个文件的 error
上传失败不等于 $_FILES 为空——比如用户点了“上传”但没选文件，或单个文件超限，error 字段会是 UPLOAD_ERR_NO_FILE（4）或 UPLOAD_ERR_INI_SIZE（1）。跳过检查直接移动会导致警告甚至覆盖风险。
立即学习“PHP免费学习笔记（深入）”；
-
UPLOAD_ERR_OK（0）才表示上传成功 -
UPLOAD_ERR_NO_FILE（4）常见于前端未选文件却提交了空数组 -
UPLOAD_ERR_FORM_SIZE（2）说明表单中MAX_FILE_SIZE隐藏域限制被触发（仅客户端校验，不可靠）
实操建议：
foreach ($uploaded_files as $file) {
if ($file['error'] !== UPLOAD_ERR_OK) {
error_log("Upload failed for {$file['name']}: error {$file['error']}");
continue;
}
$target = '/var/www/uploads/' . basename($file['name']);
if (move_uploaded_file($file['tmp_name'], $target)) {
echo "Saved: {$target}\n";
}
}
前端 <input multiple> 和后端命名必须严格匹配
浏览器发送多文件时，只有 name 带方括号（如 name="docs[]"），PHP 才会把同名字段聚合成数组结构。漏掉 [] 会导致只收到最后一个文件。
常见错误写法：
-
<input type="file" name="docs" multiple>→ 后端只拿到一个文件（最后那个） -
<input type="file" name="docs[]">（没加multiple）→ 只能选一个，但后端仍需展平逻辑（兼容性考虑）
正确写法（支持多选 + 正确解析）：
<form enctype="multipart/form-data" method="post"> <input type="file" name="docs[]" multiple accept="image/*,.pdf"> <button type="submit">Upload</button> </form>
大文件或大量文件时，upload_max_filesize 和 max_file_uploads 必须同步调高
PHP 默认限制单文件 2MB（upload_max_filesize）、一次最多上传 20 个文件（max_file_uploads）。上传 50 个 1MB 文件会卡在第 21 个，且报错信息极不明确（$_FILES 里对应项为全空或 error=0 但 tmp_name 为空）。
检查方式：
var_dump(ini_get('upload_max_filesize'), ini_get('max_file_uploads'));
// 输出类似：string(3) "2M" string(2) "20"
调整建议：
- 修改
php.ini：设upload_max_filesize = 8M、max_file_uploads = 100 - 若无法改配置，可在脚本开头用
ini_set()尝试（部分 SAPI 不生效） - 注意
post_max_size必须 ≥ 所有文件总大小 + 其他表单数据
真正容易被忽略的是：这些限制是 PHP 解析层硬限制，不抛异常，只静默截断或丢弃超出部分——必须主动校验 count($uploaded_files) 是否等于预期数量。
