ThinkPHP 6 多文件上传需先确认前端传标准 multipart 数组格式，TP6.0.13+ 支持 $request->file('images') 返回数组，低版本需循环调用；每个 File 实例须单独 validate() 后再 move()，否则报“Uploaded file is not valid”；验证失败时应先移至临时目录再统一处理，自定义规则中可直接调用 $value->getSize() 或 $value->getOriginalName() 获取文件信息。
ThinkPHP 6 的 file() 和 validateRule() 怎么配合做多文件上传校验
ThinkPHP 6 默认不自动处理多文件数组结构，直接用 $request->file('images') 拿到的是一个 think\File 实例（单文件）或 null（多文件未正确解析）。必须先确认前端传的是标准的 multipart 数组格式，例如：images[0]、images[1]，而非 images[]（部分浏览器/框架会扁平化，TP6 不识别）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 前端确保使用
name="images[]"并配合multiple属性，但服务端需手动调用$request->file()多次或改用$request->file()的数组形式支持 —— TP6.0.13+ 才支持$request->file('images')返回File对象数组；低版本必须用循环：for ($i = 0; $i + <code>new File(...) - 校验不能只靠
validateRule()静态方法，它只校验规则语法；真正触发文件校验要用$file->validate(['size' => 2097152, 'ext' => 'jpg,png,gif']) - 注意
ext规则校验的是原始后缀（$_FILES['x']['name']），不是 MIME 或内容检测，上传evil.jpg.php会被放过
为什么 $file->move() 批量调用后部分文件丢失或报错 Upload ed file is not valid
这个错误通常不是校验失败，而是 move() 前没重新调用 validate()。TP6 中每个 File 实例的校验状态是一次性的：调用过 validate() 后再调 move() 才安全；如果跳过校验或校验失败后仍调 move()，就会触发该提示。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 对每个
File实例单独校验并检查返回值：if (!$file->validate(['size'=>5242880, 'ext'=>'pdf,docx'])) { echo $file->getError(); continue; } - 不要复用同一个
File实例多次调move()—— 它内部会重命名临时文件，第二次调用时源文件已不存在 - 批量移动前建议统一生成唯一子目录（如
date('Ymd').'/'.uniqid()），避免并发写入冲突
如何在验证失败时保留已上传成功的文件并返回对应错误信息
TP6 的 File::move() 是原子操作，不提供“回滚”机制。想实现“部分成功 + 明确错误映射”，必须手动管理临时路径和错误收集。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 所有文件先统一 move 到临时目录（如
runtime/upload_tmp/），校验通过后再批量移到目标目录；失败时清理临时目录即可 - 用索引数组记录结果：
$results[$i] = ['success' => false, 'error' => $file->getError(), 'original_name' => $file->getOriginalName()] - 别依赖
$file->getError()的中文信息做前端展示，它受语言包影响；建议统一转成英文 code（如'file_too_large'），前端按 code 映射文案
validateRule() 自定义规则里怎么获取当前正在校验的文件名或大小
自定义验证规则函数接收的参数是字段值（即 File 对象），不是字符串。所以规则里可以直接调 $value->getSize() 或 $value->getOriginalName()，无需额外传参。
实操示例：
// 在 validate() 调用中
$file->validate([
'size' => 1024 * 1024,
'ext' => 'jpg,png',
function ($value) {
return mb_strlen(pathinfo($value->getOriginalName(), PATHINFO_FILENAME), 'utf-8') <= 20;
}
]);
注意：闭包规则返回 false 时，$file->getError() 不会自动设值，需手动赋值：$file->setError('filename_too_long');
多文件上传真正的复杂点不在语法，而在于临时文件生命周期管理、错误与文件的精确绑定、以及前端无法感知单个文件失败时的降级策略。这些细节不写进文档，但线上一出问题就是 500 或静默丢文件。
