用户输入永远不可信,验证是接口的第一道防线。官方手册《验证》一章下设多个子类:快速验证、内置验证规则、自定义规则、验证器类、验证场景、控制器验证。本文逐一整理,结尾附综合小实例。参考: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 | 邮箱/网址/IP | email |
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() 走异常,任选。