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