PHP多文件上传的$_FILES结构是按字段键名组织的二维数组，需用array_map(null, ...)按列合并为文件维度数组才能正确遍历；必须检查$error、过滤扩展名、并确保upload_max_filesize等配置合理。
PHP多文件上传的$_FILES结构必须先理清
PHP原生不支持“单个input提交多个文件后自动拆成独立数组”，而是把同名多文件字段打包成嵌套二维数组。如果前端写的是<input type="file" name="photos[]" multiple>，$_FILES['photos']会是这种结构：
Array(
'name' => ['a.jpg', 'b.png', 'c.pdf'],
'type' => ['image/jpeg', 'image/png', 'application/pdf'],
'tmp_name' => ['/tmp/phpabc123', '/tmp/phpdef456', '/tmp/phpghi789'],
'error' => [0, 0, 0],
'size' => [12345, 67890, 23456]
)
直接foreach($_FILES['photos'] as $file)会遍历每个键（name/type/tmp_name…），不是遍历每个文件——这是最常踩的坑。
用array_map()重组为文件维度数组才好循环处理
要让每个文件变成一个独立数组项（比如['name'=>'a.jpg','tmp_name'=>'/tmp/xxx',...]），得手动转结构。推荐用array_map()配合...展开语法，简洁且兼容PHP 5.6+：
$files = array_map(null, $_FILES['photos']['name'],
$_FILES['photos']['type'],
$_FILES['photos']['tmp_name'],
$_FILES['photos']['error'],
$_FILES['photos']['size']);
foreach ($files as $file) {
list($name, $type, $tmp_name, $error, $size) = $file;
if ($error === UPLOAD_ERR_OK) {
$ext = pathinfo($name, PATHINFO_EXTENSION);
$new_path = 'uploads/' . uniqid() . '.' . strtolower($ext);
move_uploaded_file($tmp_name, $new_path);
}
}
注意点：
立即学习“PHP免费学习笔记（深入）”；
-
array_map(null, ...)本质是“按列合并”，比手写for($i=0; $i<count(...); $i++)更安全，自动对齐各子数组长度 - 必须检查
$error === UPLOAD_ERR_OK，否则可能把UPLOAD_ERR_NO_FILE或UPLOAD_ERR_INI_SIZE当有效文件处理 - 别直接用
$_FILES['photos']['name'][$i]拼路径，用户可控的$name可能含../或空字节，需过滤扩展名而非全名
大文件或多文件并发时，upload_max_filesize和max_file_uploads会拦路
即使前端允许选10个文件，PHP默认max_file_uploads=20，但若单个文件超upload_max_filesize=2M，整个请求会被截断，$_FILES为空——此时$_POST也收不到，连错误提示都难捕获。
排查方法：
- 用
var_dump($_FILES)确认是否为空，再查error_get_last()看是否有"Unable to open buffer"类提示 - 在
phpinfo()里核对upload_max_filesize、post_max_size（必须≥所有文件总大小）、max_file_uploads - Apache下还需确认
LimitRequestBody未设过小；Nginx下检查client_max_body_size
前端multiple属性和后端循环逻辑要严格对应
常见错配：
- 前端写
<input name="avatar">（无[]、无multiple），却想传多个——PHP只接收第一个，其余丢弃 - 前端写了
multiple但没加[]，如name="photos"，PHP会把最后一个文件覆盖到$_FILES['photos']，前面的全没了 - 用JS动态创建
input[type=file]并append到表单，但没设name="files[]"，结果只有最后一个生效
可靠写法只有一种：<input type="file" name="files[]" multiple accept="image/*">，后端死守$_FILES['files']结构处理。
真正麻烦的从来不是循环本身，而是$_FILES那套反直觉的二维设计，以及配置项之间隐晦的依赖关系。改完代码不测配置，等于白干。
