自定义文件上传验证器必须继承think\validate类，不能仅用$file->validate()；需将file对象手动传入验证数据数组，并在规则中声明file类型标识，否则size、ext等规则无效。
自定义文件上传验证器必须继承 Validate，不能直接用 file->validate() 替代
很多人误以为调用 $file->validate(['size'=>102400]) 就算“用了验证器”，其实这只是临时校验，不走验证器类逻辑，无法复用、无法统一提示语、也无法和字段级规则联动。真正要自定义文件上传验证器，必须新建一个继承 think\Validate 的类，并在 $rule 中显式声明文件字段，且规则需包含 file 类型标识。
常见错误现象：check() 总是返回 true，或报错 “Undefined index: file”——这是因为传给 check() 的数据里没把文件对象当普通字段传进去，而验证器默认只处理数组键值，不自动解析 $_FILES。
- 文件字段必须作为数组键传入，例如
$data = ['avatar' => $request->file('avatar')] -
$rule中对应字段规则必须带file，如'avatar' => 'require|file|image'（image是 TP5 内置的文件类型判断） - 若要限制大小/后缀等，不能只写
size:102400，得配合file使用，否则规则不生效
file 规则和 image、size、ext 的组合逻辑很关键
TP5 的验证器对文件字段的支持是“半托管”的：它识别 file 类型后，才允许后续规则（如 image、size、ext）作用于该文件对象；否则这些规则会被当成字符串去校验字段名本身。
比如写成 'avatar' => 'require|size:102400'，验证器会尝试检查字符串 "avatar" 的长度是否为 102400，显然永远失败。
- 正确写法：
'avatar' => 'require|file|size:102400|ext:jpg,png,gif|image' -
image会调用getimagesize()判断是否为真实图片，比单纯看后缀更安全 -
size单位是字节，不是 KB；ext不区分大小写，但逗号分隔不能有空格 - 若需自定义错误提示，必须在
$message中按字段+规则命名，如'avatar.size' => '头像不能超过100KB'
自定义方法验证文件内容（比如检查 PNG 是否带透明通道）
内置规则覆盖不了业务级文件内容校验时，就得写自定义方法。注意：该方法接收的第一个参数是 \think\File 对象，不是文件路径或二进制内容。
容易踩的坑：直接对 $value 调用 file_get_contents() 会失败，因为 $value 是对象，得先用 $value->getInfo()['tmp_name'] 拿到临时文件路径。
- 方法签名必须是
function checkAlphaPng($value, $rule, $data, $field) - 内部可用
imagecreatefrompng($value->getInfo()['tmp_name'])加载并检测 alpha 通道 - 验证失败必须返回字符串错误信息，成功返回
true，不能返回空或null - 规则中绑定方式：
'avatar' => 'require|file|checkAlphaPng'
控制器里调用时，$data 必须手动注入 File 对象
验证器不会自动从 $_FILES 或 Request 提取文件，你得自己把 request()->file('xxx') 包进待验证数据数组。这是最常被忽略的一环。
如果漏了这步，check() 会因字段缺失直接返回 false，但 getError() 可能为空——因为规则没触发，只是字段不存在。
- 正确组装：
$data = ['cover' => $this->request->file('cover'), 'title' => $this->request->post('title')] - 不要传
$_FILES['cover']原始数组，验证器只认\think\File实例 - 多文件场景下，
$files = $this->request->file('images')是数组，需逐个转成键值对或改用循环校验 - 批量验证开启
protected $batchValidate = true后，错误信息才是完整数组，否则只返回第一个失败项
File 对象 → 手动塞进验证数据 → 验证器识别 file 类型 → 调用底层 move() 前的临时文件操作。任何一环断开，都会静默失败或报错不明。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
