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