ThinkPHP多图上传需显式启用数组解析：TP6用$request->file('images', false, true)，TP5.1需手动遍历$_FILES并封装think\File实例，验证与移动均须逐个处理且注意命名唯一性和错误清理。
ThinkPHP 多图上传时 $request->file() 返回 null 或单个文件
多图上传表单字段名带 []（如 images[]），但直接调用 $request->file('images') 在 ThinkPHP 6 中默认只取第一个，后续文件被忽略——这是最常踩的坑。
根本原因是：$request->file() 默认行为是「单文件提取」，即使传入的是数组型 name，它也不会自动展开为文件列表，除非显式启用数组解析。
- 必须传入第三个参数
true：$request->file('images', false, true)，其中第三个参数表示「是否解析为数组」 - 不加该参数或传
false，哪怕前端发了 5 个文件，也只拿到第 1 个think\File实例 - ThinkPHP 5.1 不支持第三个参数，需改用
$request->file()无参调用再手动过滤键名（见下一条）
ThinkPHP 5.1 怎么安全遍历 $_FILES['images'] 数组
TP5.1 的 $request->file() 不支持批量提取，硬调 $request->file('images') 会报错或返回空；得退回到原生 $_FILES 层做结构校验和封装。
- 先检查
$_FILES['images']['error']是否为数组：不是则说明前端没发多图，或字段名写错（比如漏了[]） - 用
array_filter()过滤掉error === UPLOAD_ERR_NO_FILE的项，避免空文件干扰验证 - 对每个有效项手动 new
think\File：new \think\File($_FILES['images']['tmp_name'][$i], $_FILES['images']['name'][$i], $_FILES['images']['type'][$i], $_FILES['images']['size'][$i], $_FILES['images']['error'][$i]) - 注意：别直接用
$_FILES['images']整体传给think\File构造器——它的构造器不接受完整$_FILES子数组
验证多个文件时 validateFile() 逐个调用还是批量？
ThinkPHP 自带的 validateFile() 是单文件验证方法，没有内置批量接口。强行把整个数组传进去会触发类型错误或跳过校验。
立即学习“PHP免费学习笔记（深入）”；
- 必须循环调用：对每个
think\File实例单独执行$validate->check($file) - 推荐提前定义规则数组，例如
['size' => 2097152, 'ext' => 'jpg,png,gif']，避免在循环里重复写规则 - 遇到第一个失败就中断（
break），或收集所有错误信息——取决于业务是否允许“部分成功” - 注意：
validateFile()内部会调用$file->isValid()，如果文件已移动或关闭，会返回false，所以验证必须在move()前完成
上传后文件名冲突、覆盖或丢失的常见原因
多图上传时用 $file->move()，看似简单，但并发或同名文件极易出问题——尤其没设唯一子目录或没重命名。
- 别共用一个目标路径：5 个文件都往
public/uploads/写，同名就会覆盖；应为每次请求生成唯一子目录，如date('Ymd').'/'.uniqid() -
$file->getOriginalName()可能含路径或非法字符（如../a.jpg），必须用pathinfo()提取扩展名，并用md5(uniqid()).'.'.$ext重命名 - TP6 的
move()默认不覆盖，但若目标存在且$replace = true，又没控制好命名逻辑，就会静默覆盖——建议始终设$replace = false并捕获think\exception\FileException - 上传中途失败（如某张图超限），前面成功的文件已写入磁盘，但事务未回滚——需在验证全部通过后再统一 move，或失败时手动 unlink 已传文件
多图上传真正的复杂点不在语法，而在错误边界：哪张图失败了？失败前传了几张？要不要清理？这些逻辑一旦漏掉，线上就容易积攒脏文件或丢数据。
