ThinkPHP5.1 验证器

ThinkPHP5.1推荐使用验证器进行数据验证(也支持使用\think\Validate类进行独立验证)。

验证器定义

为具体的验证场景或者数据表定义好验证器类,直接调用验证类的check方法即可完成验证,下面是一个例子:

我们定义一个\app\index\validate\User验证器类用于User的验证。

namespace app\index\validate;

use think\Validate;

class User extends Validate

{

protected $rule = [

'name' => 'require|max:25',

'email' => 'email',

];

}

V5.1.15+版本开始,可以使用下面的指令快速生成User验证器。

php think make:validate index/User

可以直接在验证器类中使用message属性定义错误提示信息,例如:

namespace app\index\validate;

use think\Validate;

class User extends Validate

{

protected $rule = [

'name' => 'require|max:25',

'age' => 'number|between:1,120',

'email' => 'email',

];

protected $message = [

'name.require' => '名称必须',

'name.max' => '名称最多不能超过25个字符',

'age.number' => '年龄必须是数字',

'age.between' => '年龄只能在1-120之间',

'email' => '邮箱格式错误',

];

}

如果没有定义错误提示信息,则使用系统默认的提示信息

数据验证

在需要进行User验证的控制器方法中,添加如下代码即可:

namespace app\index\controller;

use think\Controller;

class Index extends Controller

{

public function index()

{

$data = [

'name' => 'thinkphp',

'email' => 'thinkphp@qq.com',

];

$validate = new \app\index\validate\User;

if (!validate-\>check(data)) {

dump($validate->getError());

}

}

}

事实上控制器类提供了一个validate方法可以更方便的进行验证,如下:

namespace app\index\controller;

use think\Controller;

class Index extends Controller

{

public function index()

{

result = this->validate(

[

'name' => 'thinkphp',

'email' => 'thinkphp@qq.com',

],

'app\index\validate\User');

if (true !== $result) {

// 验证失败 输出错误信息

dump($result);

}

}

}

批量验证

默认情况下,一旦有某个数据的验证规则不符合,就会停止后续数据及规则的验证,如果希望批量进行验证,可以设置:

namespace app\index\controller;

use think\Controller;

class Index extends Controller

{

// 是否批量验证
protected $batchValidate = true;

public function index()

{

result = this->validate(

[

'name' => 'thinkphp',

'email' => 'thinkphp@qq.com',

],

'app\index\validate\User');

if (true !== $result) {

// 验证失败 输出错误信息

dump($result);

}

}

}

在非控制器的地方如果需要执行批量验证,可以在验证的时候添加是否批量的方法batch()

namespace app\common\service;

use app\common\validate\User as UserValidate;

class Test

{

public function validateTest($data)

{

$validata = new UserValidate;

result = validate->batch()->check($data);

if ($result !== true) {

dump($result);

}

}

}

批量验证如果验证不通过,返回的是一个错误信息的数组。

抛出验证异常

默认情况下验证失败后不会抛出异常,如果希望验证失败自动抛出异常,可以在控制器类中添加设置:

namespace app\index\controller;

use think\Controller;

class Index extends Controller

{

// 验证失败是否抛出异常
protected $failException = true;

public function index()

{

result = this->validate(

[

'name' => 'thinkphp',

'email' => 'thinkphp@qq.com',

],

'app\index\validate\User');

}

}

设置开启了验证失败后抛出异常的话,无需手动获取错误信息,会自动抛出think\exception\ValidateException异常或者自己捕获处理。

自定义验证规则

系统内置了一些常用的规则(参考后面的内置规则),如果不能满足需求,可以在验证器重添加额外的验证方法,例如:

namespace app\index\validate;

use think\Validate;

class User extends Validate

{

protected $rule = [
'name' => 'checkName:thinkphp',

'email' => 'email',

];

protected $message = [

'name' => '用户名必须',

'email' => '邮箱格式错误',

];

// 自定义验证规则
protected function checkName(value,rule,data=\[\]) { return rule == $value ? true : '名称错误';
}

}

验证方法可以传入的参数共有5个(后面三个根据情况选用),依次为:

相关推荐
FungLeo10 小时前
FengCMS · PHP+MySQL 升级实录 ·三重 MD5 迁移 password_hash:老站密码怎么无痛升级
mysql·php·哈希算法·密码安全·fengcms
ServBay11 小时前
PHP 8.6 最新发布:语法更新、实用函数与升级要点
后端·php
FungLeo19 小时前
FengCMS ·PHP+MySQL 升级实录 · 安全加固的克制:一份“不做什么“清单,比修了几个漏洞更重要
mysql·安全·php·安全加固·fengcms
.痞老板.1 天前
java ee--网络编程套接字
网络·java-ee·php
JianZhen✓3 天前
IM 聊天列表为什么总“消息乱跳“:有序插入、时间轴派生、本地截断、已读回执
开发语言·前端·php
FungLeo3 天前
FengCMS · PHP+MySQL 升级实录· 代码审计怎么闭环:REVIEW到 CLOSURE 四件套,12 个域90 篇修复文档跟到底
开发语言·mysql·php·代码审计·fengcms
FungLeo3 天前
FengCMS · PHP+MySQL 升级实录 · 一个不懂PHP 的后端,三天 216次提交完成十三年老站安全升级(项目复盘)
mysql·安全·php·安全加固·fengcms
pps-key3 天前
网络攻防入门:从“黑客梦”到合法实操(生存篇)
开发语言·web安全·php
驭渊的小故事3 天前
订单服务如何调用商品服务?一次 RestTemplate 跨服务调用入门
java·开发语言·php
Risehuxyc4 天前
来自PHP项目devnexen的回信
开发语言·php