在 ThinkPHP 5 中配置自定义验证器类，需在 app/validate 目录下创建继承 think\Validate 的类，定义 $rule 属性，并在控制器中实例化后调用 check() 方法。该方式适用于业务逻辑复杂、需复用验证规则的场景，风险在于字段名大小写不一致会导致验证静默失效。
先说结论：TP5 自定义验证器核心是继承基类、定义规则数组、调用检查方法，通过分离验证逻辑提升代码可维护性。
- 适合：业务规则稳定、多控制器复用验证逻辑的场景
- 先看：验证器类命名空间是否为 app\validate 且继承正确
- 建议：字段名与提交数据键名严格一致，避免大小写差异
命令速用版
<?php
namespace app\validate;
use think\Validate;
class User extends Validate
{
protected $rule = [
'username' => 'require|alphaNum|min:3|max:20',
'email' => 'require|email'
];
}
// 控制器调用
$validate = new \app\validate\User();
if (!$validate->check($data)) {
return $validate->getError();
}为什么会这样
自定义验证器类能将数据校验逻辑从控制器中剥离，避免控制器代码臃肿。ThinkPHP 5 框架设计验证器为独立类，支持静态规则定义和动态规则构建，若直接在控制器写验证代码，会导致重复逻辑难以维护且无法复用场景配置。
分步处理
1. 创建验证器文件：在 app/validate 目录下新建 PHP 文件，如 User.php，类名与文件名一致。
2. 继承基类：类定义需继承 think\Validate，确保加载框架内置验证方法。
3. 定义规则：在类中声明 protected $rule 数组，键为字段名，值为验证规则字符串或数组。
4. 自定义方法：若内置规则不足，可在类中定义 protected 函数，函数名即为规则名，返回 true 或通过字符串返回错误信息。
5. 控制器调用：实例化验证器类，传入待验证数据数组调用 check() 方法，根据返回值判断是否通过。
怎么验证是否生效
提交不符合规则的数据，检查 check() 方法是否返回 false，并调用 getError() 获取错误提示字符串。若返回 true 但数据明显违规，需检查字段名是否与$data 数组键名完全一致，包括大小写和下划线。
常见坑
1. 字段名不匹配：验证规则中的键名必须与待验证$data 数组的键名完全一致，大小写敏感，否则验证器会跳过该字段。
2. 联合唯一校验格式：unique 规则不支持字符串形式的联合字段，必须用数组格式显式指定表名和字段列表，否则验证失效。
3. 更新操作排除：编辑数据时需显式传入排除字段及值，否则验证器会将当前记录自身判为重复项。
4. 场景未启用：若定义了 scene 属性但未在调用时指定场景，默认验证所有规则，可能导致非必要字段报错。
常见问题
如何自定义验证规则方法？
在验证器类中定义 protected 函数，函数名作为规则名，参数依次为值、规则、全部数据、字段名，返回 true 或错误字符串。
验证失败如何获取所有错误？
在控制器类顶部声明 protected $batchValidate = true，或调用验证器时启用批量验证模式，getError() 将返回所有错误信息。
动态规则如何配置？
使用 Validate::make($rules) 动态构建验证器实例，适用于规则来源于数据库或配置中心的场景，无需定义独立类。
参考来源
- ThinkPHP 怎样配置验证器规则_验证器规则配置方法【详解】
- thinkphp5.0 自定义验证器
- TP5 学习 (十一):验证_tp alphadash-CSDN 博客
- TP5 框架中验证器的使用详解-CSDN 博客
- thinkPHP5 框架自定义验证器实现方法分析
- TP5 自定义验证器 - 吃饭睡觉打豆豆 o - 博客园
- ThinkPHP 如何自定义验证器多字段_ThinkPHP 联合唯一校验教程【教程】