技术 · 思考 · 实践 · 成长

首页/ThinkPHP8/正文

ThinkPHP 8 验证完全指南:内置规则、自定义规则、验证器与验证场景

ThinkPHP87 次阅读

用户输入永远不可信,验证是接口的第一道防线。官方手册《验证》一章下设多个子类:快速验证、内置验证规则、自定义规则、验证器类、验证场景、控制器验证。本文逐一整理,结尾附综合小实例。参考:ThinkPHP 8 验证。

一、快速验证

用 thinkfacadeValidate 直接传规则验证数组:

use thinkfacadeValidate;

$data = ['name' => 'think', 'age' => 20, 'email' => 'tp@thinkphp.cn'];

$result = Validate::check($data, [
    'name'  => 'require|max:25',
    'age'   => 'number|between:1,120',
    'email' => 'email',
]);

if (! $result) {
    echo Validate::getError();      // 第一条错误信息
}

规则用竖线串联,规则名:参数 传参(如 max:25、between:1,120)。

二、内置验证规则

规则作用示例
require必填require
number / integer / float数字/整数/浮点integer
boolean / array / accepted布尔/数组/是否接受accepted
email / url / ip邮箱/网址/IPemail
dateFormat日期格式dateFormat:Y-m-d
in / notIn枚举范围in:1,2,3
between / notBetween区间(数字或长度)between:1,120
length / max / min长度/最大/最小max:25
egt/gt/elt/lt/eq大于等于/大于/小于等于/小于/等于egt:0
confirm / different两字段一致/不一致(确认密码)confirm:password
filter / regex过滤器/正则regex:pattern
requireIf / requireWith条件必填requireIf:type,1

三、自定义规则

1. 扩展全局规则(常用)

use thinkfacadeValidate;

Validate::extend('mobile', function ($value) {
    return preg_match('/^1[3-9]\d{9}$/', $value);
});

// 之后所有验证里可直接用 mobile 规则
'phone' => 'require|mobile',

2. 闭包规则(局部使用)

Validate::check($data, [
    'name' => function ($value) {
        return strlen($value) >= 2;      // 返回 true/false
    },
]);

四、验证器类与验证场景

规则多时封装成验证器类,放在 app/validate 目录:

<?php
namespace appvalidate;

use thinkValidate;

class User extends Validate
{
    protected $rule = [
        'name'  => 'require|max:25',
        'age'   => 'require|number|between:1,120',
        'email' => 'require|email',
    ];

    protected $message = [
        'name.require' => '用户名不能为空',
        'name.max'     => '用户名最长25个字符',
        'age.between'  => '年龄必须在1~120之间',
        'email'        => '邮箱格式错误',
    ];

    protected $scene = [
        'create' => ['name', 'age', 'email'],
        'edit'   => ['name', 'email'],    // 编辑时不要求年龄
    ];
}

使用场景:scene('edit') 只验证编辑用到的字段;错误信息用 字段名.规则名 精确到每条规则;getError() 取第一条错误,fail() 取全部错误数组。

五、控制器里验证

$data = request()->post();

// 写法1:主动 check,不走异常
$validate = validate('appvalidateUser');
if (! $validate->scene('create')->check($data)) {
    return json(['code' => 0, 'msg' => $validate->getError()]);
}

// 写法2:基类 validate(),校验失败抛异常
try {
    $this->validate($data, 'appvalidateUser.create');
} catch (Exception $e) {
    return json(['code' => 0, 'msg' => $e->getMessage()]);
}

六、综合小实例:用户注册验证

把验证器、场景、自定义规则串起来:

// 1. 自定义手机号规则(公共初始化里注册一次)
Validate::extend('mobile', function ($value) {
    return preg_match('/^1[3-9]\d{9}$/', $value);
});

// 2. 验证器 app/validate/Register.php:规则 + 中文错误 + register/edit 场景
//    $rule 含 username(require|max:20)、mobile(require|mobile)、password(require|min:6|confirm:repassword)

// 3. 控制器
public function register()
{
    $data = request()->post();
    $validate = validate('appvalidateRegister');
    if (! $validate->scene('register')->check($data)) {
        return json(['code' => 0, 'msg' => $validate->getError()]);
    }
    // 验证通过:入库...
    return json(['code' => 1, 'msg' => '注册成功']);
}

一个注册接口用到了内置规则(require/max/min/confirm)、自定义规则(mobile)、验证器类、验证场景和控制器验证 —— 本章要点全覆盖。

七、总结

规则竖线串联、冒号传参;常用内置规则记住 require/number/email/length/confirm;手机号等格式用 extend 或 regex 自定义;规则多了封装验证器类,message 精确到 字段.规则;用 scene 一套规则多场景复用;控制器里 check() 走返回值、validate() 走异常,任选。

无才无以立足,不苦不能成才。

评论交流

0 条评论 · 支持多级回复
验证码
暂无评论,来说说你的想法吧

相关文章

继续阅读