TP6.0 如何实现数据校验？自定义验证规则与 Unique 验证场景【表单】

TP6.0验证器规则需显式加载，unique必须指定表名字段，自定义规则须返回bool或字符串，批量校验和场景白名单需主动开启。

验证器类必须显式加载规则才能生效

TP6.0 的 thinkValidate 实例化后默认不自动读取 $rule 属性，除非你调用 check() 前已通过构造或链式方式注入规则。常见错误是只写了 protected $rule = [...] 却没在控制器里触发加载逻辑。

• 正确做法：新建验证器类（如 app/validate/UserRegisterValidate.php），继承 thinkValidate，并在 $rule 中写明字段规则；不能只靠属性声明就认为规则已注册
• 调用时必须显式传入数据并执行 check($data)，例如：validate(UserRegisterValidate::class)->check($data)
• 若使用 $this->validate($data, 'UserRegisterValidate')，控制器需继承 thinkController，且验证器类路径必须与命名一致

Unique 验证必须带表名且注意字段映射

unique 规则在 TP6.0 中不是开箱即用的“智能检测”，它依赖数据库连接和明确的表结构。写成 'username' => 'unique' 会直接报错或静默失效。

• 语法格式固定为 unique:表名,字段名,排除ID,额外条件，最简形式是 unique:user,username
• 如果要排除当前编辑记录（比如修改用户时不校验自己），第三个参数填主键值，如 unique:user,username,5 表示跳过 ID=5 的记录
• 字段名必须与数据库字段完全一致；若提交字段是 user_name 但数据库字段是 username，需显式指定：'user_name' => 'unique:user,username'
• 确保模型或连接配置中已启用对应数据库，并且该表真实存在、可读

自定义规则函数必须返回 bool 或字符串错误提示

TP6.0 对自定义规则的返回值类型非常敏感：返回 true 表示通过，false 或字符串表示失败。返回其他类型（如 null、数字、数组）会导致校验中断或异常。

• 函数签名必须为 function($value, $rule, $data, $field)，其中 $data 是整条数据，可用于跨字段判断
• 例如密码确认规则：protected function confirmPassword($value, $rule, $data, $field) { return $value === ($data['password'] ?? ''); }
• 若需带提示语，直接返回字符串，如 return '两次输入的密码不一致';，此时 $message 中对应项（如 'password.confirmPassword'）会被忽略
• 全局扩展规则（通过 Validate::extend()）同样遵循该返回约定，且必须在服务启动时注册（如 app/AppService.php 的 boot() 方法中）

批量错误收集与场景白名单必须主动开启

默认情况下，TP6.0 验证器遇到第一个错误就停止校验并返回单条提示。要一次性拿到所有错误，或只校验部分字段，得手动控制。

• 启用批量错误：调用 batch(true)，如 validate(...)->batch(true)->check($data)，返回的是错误数组而非字符串
• 字段白名单必须用 scene() 显式声明，否则 $rule 全部失效；例如 scene('register') 对应验证器内 sceneRegister() 方法
• sceneRegister() 内必须用 $this->only([...]) 列出字段，或用 append() 加入联动字段（如密码确认），否则 confirm_password 不参与校验
• 数组字段校验要用 tags.* 语法，例如 'tags.*' => 'max:20|regex:/^[a-zA-Z0-9u4e00-u9fa5]+$/'，否则规则只作用于整个数组而非每个元素

实际写验证器时，最容易被忽略的是 scene 的调用时机和 unique 的表名拼写——少一个字母、多一个空格，都会让唯一性校验形同虚设。