必须用 request()->file('files')，不能直接调 request()->file()——后者只取第一个文件且返回单个对象，循环会报错；HTML 表单 name 必须为 "files[]"，后端接收名需匹配 'files'。
ThinkPHP 多文件上传用 request()->file() 还是 request()->file('name')？
必须用 request()->file('files')（传数组名），不能直接调 request()->file()——后者只取第一个文件，且返回单个 think\File 对象，不是数组，循环会报错。
常见错误现象：Invalid argument supplied for foreach() 或只处理了第一个文件就结束。
- HTML 表单中
<input type="file" name="files[]" multiple>，注意[]，后端接收名必须匹配（如'files'） - 如果前端没加
[]但用了multiple，浏览器仍会发多个同名字段，ThinkPHP 默认只收第一个——这是最常踩的坑 - 验证时别对整个数组调
validate(['file' => 'require|image'])，得遍历每个think\File实例单独验
批量上传时怎么统一校验格式、大小并跳过失败项？
ThinkPHP 的 validateRule 不支持直接校验文件数组，必须手动遍历每个 think\File 实例，用 isValid() + getInfo() + 自定义规则判断。
容易忽略的点：上传失败的文件（如超限、类型不符）在 $_FILES 中 error 值非 0，但 request()->file() 默认会过滤掉这些“无效”文件——你以为拿到了全部，其实已经丢了几条。
立即学习“PHP免费学习笔记（深入）”；
- 先用
request()->file('files')拿到文件对象数组，再用array_map或foreach处理每个$file - 每轮先检查
$file->isValid()，否则后续moveTo()必然失败 - 大小限制建议用
$file->getSize() <= 2 * 1024 * 1024（比如 2MB），别依赖表单 hidden 字段或客户端 JS，不安全 - 图片类型验证别只看
getExtension()，要结合$file->getMimeType()，例如image/jpeg、image/png
moveTo() 批量保存时路径冲突和命名怎么处理？
直接用 $file->moveTo($path) 会覆盖同名文件，而且默认不生成唯一文件名——并发上传或重名文件极易出问题。
ThinkPHP 的 move() 方法（带参数）比 moveTo() 更合适，它自动处理重命名、目录创建和异常捕获。
- 用
$file->move($rootPath, $saveName, true)，第三个参数true表示自动重命名（如加时间戳+随机串） -
$saveName可设为null让框架自动生成，或传自定义前缀（如'upload_' . date('ymd')） - 确保
$rootPath是绝对路径，推荐用root_path('public') . 'uploads/'，别拼相对路径 - 每次
move()返回think\File对象或false，必须判断返回值再记录结果，不能假设一定成功
上传后怎么拿到所有成功文件的路径并关联业务数据？
别在循环里直接写数据库，尤其涉及事务时——一个失败，前面成功的就难回滚。更稳妥的是先收集结果，再统一入库或异步处理。
另一个隐形坑：ThinkPHP 的 move() 成功后，$file->getSaveName() 返回的是「保存后的文件名」，而 $file->getInfo('name') 是原始上传名，别混用。
- 建一个
$results = []数组，每轮 push 包含'origin_name'、'save_name'、'path'、'size'的子数组 - 路径拼接用
str_replace(root_path(), '', $file->getPathname())得到相对 public 的 URL 路径，方便前端访问 - 如果要存进数据库，建议用事务包裹批量插入，或至少用
Db::transaction()包一层 - 大文件或多文件场景下，考虑把保存逻辑扔进队列（如 think-queue），避免请求超时
真正麻烦的不是循环本身，而是每个文件都可能在 isValid、size、type、move 四个环节任一失败，还不能中断整体流程——得逐个兜底，再汇总结果。漏判一个 !$file->isValid()，后面全崩。
