ThinkPHP多图上传需手动遍历文件数组逐个验证保存，因request()->file('images')默认只取首个文件；正确做法是用request()->file()获取全部文件并过滤images键名，再循环验证、move()保存并返回结构化结果。
ThinkPHP 多图上传不是靠 file 方法单次调用就能解决的，必须手动遍历文件数组、逐个验证并保存——否则会漏图、报错或覆盖。
为什么 request()->file() 直接取不到多图？
浏览器提交多图时，<input type="file" name="images[]" multiple> 生成的是一个文件数组，但 ThinkPHP 的 request()->file('images') 默认只取第一个（即使加了 []）。不显式遍历，后面根本拿不到第二张起的文件。
常见错误现象：Call to a member function move() on null，就是误以为 request()->file('images') 返回了数组，实际返回的是 null 或单个 File 对象。
正确做法：
立即学习“PHP免费学习笔记（深入）”；
- 用
request()->file()不带参数，获取全部上传文件的原始数组 - 过滤出键名含
images的项（比如images[0]、images[1]） - 或前端改用固定命名如
images_0、images_1，再用循环拼接读取
如何安全地批量验证并保存每张图？
不能把所有图塞进一个 validate 调用里——ThinkPHP 的文件验证规则（如 image、maxSize）是针对单个 File 对象的。对数组直接验证会失败或跳过。
实操建议：
- 遍历每个
File对象，单独调用validate(['size' => 2097152, 'ext' => 'jpg,png,gif']) - 验证失败时，记录对应索引的错误信息（比如
第2张图：文件大小超限），别直接中断 - 保存时指定不同子目录或加时间戳前缀，避免同名覆盖：
$file->move(ROOT_PATH . 'public' . DS . 'uploads' . DS . date('Ymd'), true) - 注意
move()第二个参数设为true，允许自动重命名（防冲突）
Upload 类和 think\File 的区别在哪？
ThinkPHP 6+ 已弃用 think\facade\Filesystem 中的旧 Upload 类，统一使用 think\File（即 request()->file() 返回的实例）。混用会导致方法不存在错误，比如调用 uploadOne() 报 Call to undefined method。
关键差异：
-
think\File是单文件对象，有getInfo()、isValid()、move()等方法 - 没有内置“批量上传”方法，所谓“批量”全是业务层循环实现
- 若需自定义存储（如 OSS），应使用
think\Filesystem配合writeStream()，而不是试图改造move()
保存后怎么返回结构化结果？
前端通常需要每张图的 URL 或相对路径，而不是“成功/失败”笼统反馈。别用单一布尔值响应。
推荐返回格式示例：
{
"status": "partial",
"saved": [
{ "index": 0, "url": "/uploads/20240512/abc.jpg", "size": 124589 },
{ "index": 1, "url": "/uploads/20240512/def.png", "size": 87231 }
],
"errors": [
{ "index": 2, "msg": "不是合法图片格式" }
]
}
注意点：
-
url字段不要拼全站域名，留前端自行补前缀，方便环境切换 - 如果用了缩略图，确保在保存原图后立即生成，并把缩略图路径一并写入
saved数组 - 数据库写入建议延迟到所有图保存成功后再执行，避免部分成功部分失败导致状态不一致
多图上传真正的复杂点不在上传动作本身，而在错误聚合、路径隔离、前后端约定一致性——这些地方一松懈，上线后就容易出现“图传了但看不见”“删一张图结果全没了”这类问题。
