PHP需用自定义函数展平$_FILES['photos']嵌套结构,再逐个检查error是否为UPLOAD_ERR_OK,匹配前端name="docs[]"并调高upload_max_filesize和max_file_uploads。

PHP如何正确接收 $_FILES 中的多文件数组
PHP 默认不会自动把多个同名文件输入框()解析成扁平数组,而是生成嵌套结构。直接遍历 $_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";
}
}
前端 和后端命名必须严格匹配
浏览器发送多文件时,只有 name 带方括号(如 name="docs[]"),PHP 才会把同名字段聚合成数组结构。漏掉 [] 会导致只收到最后一个文件。
技术上面应用了三层结构,AJAX框架,URL重写等基础的开发。并用了动软的代码生成器及数据访问类,加进了一些自己用到的小功能,算是整理了一些自己的操作类。系统设计上面说不出用什么模式,大体设计是后台分两级分类,设置好一级之后,再设置二级并选择栏目类型,如内容,列表,上传文件,新窗口等。这样就可以生成无限多个二级分类,也就是网站栏目。对于扩展性来说,如果有新的需求可以直接加一个栏目类型并新加功能操作
常见错误写法:
-
→ 后端只拿到一个文件(最后那个) -
(没加multiple)→ 只能选一个,但后端仍需展平逻辑(兼容性考虑)
正确写法(支持多选 + 正确解析):
大文件或大量文件时,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) 是否等于预期数量。










