thinkphp批量上传关键在于前后端规范配合、服务端正确解析多文件结构及独立校验移动；tp6.0.13+直接用$request->file('photos')获取数组，旧版需手动处理$_files；每个文件须单独validate()后move()，并建议按日期+uniqid生成唯一子目录。
ThinkPHP 实现文件批量上传，关键不在“写多少代码”，而在于前后端配合是否规范、服务端是否正确解析多文件结构、每个文件是否独立校验再移动。版本差异大，TP6.0.13+ 和旧版处理逻辑不同，不能混用。
前端表单必须规范：name 用 [] + enctype 必须是 multipart/form-data
这是整个流程的基础。不满足这两点，后端根本收不到多个文件。
-
正确写法（推荐）：
<input type="file" name="photos[]" multiple>—— 用户可多选，后端接收为数组 -
也可接受：
<input type="file" name="photos[0]"><input type="file" name="photos[1]">—— 多个独立控件，语义清晰但体验稍差 -
绝对避免：
name="photos"（单值）或name="photos[][]"（嵌套数组，TP 不识别） -
form 标签必须带：
enctype="multipart/form-data"，否则文件数据不会被发送
后端接收方式取决于 ThinkPHP 版本
TP6.0.13 及以上支持直接获取文件数组；低版本需手动展开 $_FILES 结构。
-
TP6.0.13+：直接调用
$request->file('photos')，返回think\File[]对象数组，可 foreach 遍历 -
TP6.0.12 及更早：该方法只返回第一个文件或 null，必须手动处理
$_FILES['photos']数组：
– 用array_keys($_FILES['photos']['name'])获取索引
– 构建每个文件的完整项：['name', 'tmp_name', 'size', 'type', 'error']
– 再逐个 new File() 或传给验证器
每个文件必须单独 validate()，再 move()
这是最容易出错的环节。“Uploaded file is not valid” 错误几乎都源于此。
-
$file->validate(['size' => 2097152, 'ext' => 'jpg,png,gif'])是一次性操作，校验失败后不能直接 move() - 校验通过才调
$file->move()，否则跳过并收集错误信息 - 不要复用同一个
$file实例多次 move() —— 临时文件移动后就不存在了 - 建议为每批上传生成唯一子目录，如
date('Ymd') . '/' . uniqid()，避免并发冲突
验证失败时如何返回精确错误信息
TP 没有内置“部分成功+映射错误”的机制，需手动管理。
- 先统一将所有文件移到临时目录（如
runtime/upload_tmp/），再逐个校验 - 校验失败的，记录对应原始文件名和错误原因；成功的，再正式 move 到目标路径
- 最终返回结构类似：
['success' => [...], 'failed' => [['name'=>'a.jpg','error'=>'文件过大']]> - 注意：
ext规则只检查上传时的后缀名（$_FILES['x']['name']），不检测内容，evil.jpg.php会被放过，如需防伪需额外 MIME 或文件头检测
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
