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);
}
}
注意点:
-
array_map(null, ...)本质是“按列合并”,比手写for($i=0; $i<count>更安全,自动对齐各子数组长度</count> - 必须检查
$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那套反直觉的二维设计,以及配置项之间隐晦的依赖关系。改完代码不测配置,等于白干。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











