信息发布→ 登录 注册 退出

thinkphp validate验证器自定义规则如何添加

发布时间:2025-09-24

点击量:
在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 的验证系统非常灵活,结合自定义方法、闭包和全局扩展,能应对大多数业务需求。关键是把验证逻辑封装好,保持控制器简洁。

标签:# 验证码  # 这样做  # 适用于  # 多个  # 如果你  # 类中  # 不正确  # 器中  # 你可以  # php  # 自定义  # 闭包  # 继承  # 封装  # ai  # app  # cad  # thinkphp  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!