ThinkPHP验证器自定义规则添加方法

在ThinkPHP 6.x中可通过继承Validator类定义check开头的方法、使用闭包或全局extend注册自定义规则实现灵活数据校验，如验证手机号、验证码格式等，并支持场景化规则组合。

在 ThinkPHP 中，验证器（Validate）支持自定义规则，你可以通过添加自定义验证方法来实现更灵活的数据校验。以下是添加自定义规则的几种常用方式，适用于 ThinkPHP 6.x 版本。

1. 在验证器类中定义自定义方法

创建一个继承 think\validate\Validator 的验证器类，在类中添加以 check 开头或使用闭包的方式定义规则。

假设你需要验证手机号是否为中国大陆号码，可以这样做：

namespace app\validate;

use think\Validate;

class UserValidate extends Validate
{
    protected $rule = [
        'phone' => 'require|mobile',
        'age'   => 'require|between:18,65',
        'code'  => 'require|checkCode',
    ];

    protected $message = [
        'phone.require' => '手机号不能为空',
        'phone.mobile'  => '请输入正确的手机号',
        'age.between'   => '年龄必须在18到65之间',
        'code.checkCode'=> '验证码格式不正确',
    ];

    // 自定义方法：检查验证码是否为6位数字
    protected function checkCode($value, $rule, $data, $field)
    {
        return preg_match('/^\d{6}$/', $value) === 1;
    }
}

然后在控制器中使用：

$validate = new \app\validate\UserValidate();
if (!$validate->scene('register')->check($data)) {
    echo $validate->getError();
}

2. 使用闭包添加临时自定义规则

如果你不想创建独立的验证器类，也可以在控制器中直接使用闭包定义规则。

use think\facade\Validate;

$rule = [
    'email' => 'require|email',
    'phone' => 'require|number|length:11',
    'name'  => function ($value) {
        return strlen($value) >= 2 && strlen($value) <= 20 ? true : '姓名长度必须在2-20个字符之间';
    }
];

$data = ['name' => '小明', 'email' => 'test@example.com', 'phone' => '13800138000'];

if (!Validate::rule($rule)->check($data)) {
    echo Validate::getSceneError();
}

3. 添加全局自定义规则（推荐复用场景）

你可以在应用初始化或服务提供者中注册通用规则，供多个验证器使用。

在 app/provider.php 或某个服务启动文件中：

use think\Validate;

// 注册自定义规则
Validate::maker(function (Validate $validate) {
    $validate->extend('idCard', function($value) {
        return preg_match('/^[1-9]\d{5}(18|19|20)\d{2}((0[1-9])|(1[0-2]))(([0-2][1-9])|10|20|30|31)\d{3}[0-9Xx]$/', $value);
    }, '身份证号码格式不正确');
});

之后就可以在任何验证器中使用 idCard 规则：

'id_card' => 'require|idCard'

4. 使用场景（scene）配合自定义规则

你可以为不同场景设置不同的规则组合，包括自定义方法。

protected $scene = [
    'register' => ['phone', 'code', 'age'],
    'edit'     => ['phone', 'age'],
];

这样在调用时指定场景即可自动应用对应规则。

基本上就这些。ThinkPHP 的验证系统非常灵活，结合自定义方法、闭包和全局扩展，能应对大多数业务需求。关键是把验证逻辑封装好，保持控制器简洁。