ThinkPHP验证器需手动配置和调用，场景化验证必须显式指定；推荐命令行生成、严格类型声明、合理使用only/append/remove组合及batch批量验证。
ThinkPHP 的验证器不是“写完就自动生效”的工具，它需要你主动配置、显式调用，尤其是场景化验证，稍不注意就会走默认规则，导致字段漏校验或误校验。
验证器得先建好，再用对地方
推荐用命令行生成标准结构：php think make:validate User，文件会自动落在 app/validate/User.php。生成的类首行必须有 declare(strict_types=1);，这是 PHP 8+ 强类型校验的前提。验证规则写在 $rule 数组里，比如：
-
'username' => 'require|alphaNum|max:20'—— 必填、只含字母数字、最长20位 -
'email' => 'require|email'—— 必填且格式合法 -
'tags' => 'array'—— 明确声明是数组类型，否则空数组[""]可能被忽略
场景不是自动识别的，必须手动指定
定义了 $scene = ['edit' => ['username', 'email']]，不代表控制器一调用就走 edit 场景。常见错误就是只写 $validate->check($data)，结果还是校验全部字段。
- 门面方式（最简）：
$this->validate($data, 'User.edit')—— 自动解析 . 后的场景名 - 手动实例化：
(new User())->scene('edit')->check($data)—— 必须链式调用scene() - 模型中使用需传数组：
UserModel::create($data, ['validate' => ['scene' => 'edit']])
注意：场景名大小写敏感，'Edit' 和 'edit' 是两个不同场景；拼错场景名会静默回退到全字段验证，容易误判。
立即学习“PHP免费学习笔记（深入）”；
only 和 append/remove 逻辑相反，别混用
$scene['edit'] = ['username', 'email'] 是 only 模式——只校验列出的字段，其余全跳过。适合新增等聚焦核心字段的场景。
编辑场景更推荐 append + remove 组合：
- 先定义默认规则（如含 password），再在场景中
remove('password')剔除不需要校验的字段 - 再用
append('nickname')补上编辑时才需要的新字段 - 这样避免漏掉主键 id、更新时间等关键字段
remove 对字段名严格匹配，remove('user_name') 不会移除 username 字段。
错误提示和调试要到位
批量验证建议开启：scene('edit')->batch(true)->check($data)，失败时返回所有错误，而不是只报第一条。
- 单条提示用
$validate->getError()（字符串） - 全部错误用
$validate->getErrorArray()（数组） - 调试时直接
dump($validate->getRule())，看最终生效的规则列表，比翻代码更快定位问题
require 不自动 trim，带空格的 " " 会被当成非空；数组字段需配合 array 类型声明 + 后续业务层检查 !empty($data['tags'])，不能全靠验证器兜底。
