验证器

By:Mirror王宇阳

验证器定义

验证器的使用,必须定义它;系统提供了一条命令直接生产一个验证器类:

php think make:validate User

自动再应用目录下生成一个validate文件夹,并生成User.php

namespace app\validate;
use think\Validate;
class User extends Validate
{
/**
* 定义验证规则
* 格式:'字段名' => ['规则1','规则2'...]
* '字段名' => '规则1|规则2...'
*
* @var array
*/
protected $rule = [
'name' => 'require|max:20',
'price' => 'number|between:1,100',
'email' => 'email'
]; /**
* 定义错误信息
* 格式:'字段名.规则名' => '错误信息'
*
* @var array
*/
protected $message = [
'name.require' => '姓名不得为空',
'name.max' => '姓名不得大于20位',
'price.number' => '价格必须是数字',
'price.between' => '价格位于1~100之间',
'email' => '邮箱格式错误'
];
}

自动生成的两个属性:

$rule:定义规则

$message:定义错误信息 ,如果不定义错误信息提示默认的错误信息

验证器定义之后,进行调用测试,创建一个Verify.php控制器:

namespace app\controller;
use app\validate\User;
use think\exception\ValidateException; class Verify
{
public function index()
{
try {
validate(User::class)->check([
'name' => '蜡笔小新',
'price' => 90,
'email' => 'xiaoxin@qq.com'
]);
} catch (ValidateException $err){
dump($err->getError());
}
}
}

当验证规则出现一个错误后就会停止之后字段的判断

批量验证

class Verify
{
public function index()
{
try {
$result = validate(User::class)
->batch(true)->check([
'name' => '蜡笔小新',
'price' => 90,
'email' => 'xiaoxin@qq.com'
]);
if(true !== $result){
dump($result);
}
} catch (ValidateException $err){
dump($err->getError());
}
}
}

自定义规则

系统内置提供了部分常用的规则;同时也允许开发者自定义规则:

protected function checkName($value,$rule)
{
return $rule != $value ? true : '存在非法字符';
}

自定义规则支持传入五个参数:

  • 验证数据
  • 验证规则
  • 全部数据(数组)
  • 字段名
  • 字段描述

验证规则

规则定义

protected $rule = [
'name' => 'require|max:20',
'price' => 'number|between:1,100',
'email' => 'email'
];

不仅仅支持字符串模式,也支持数组模式

protected $rule = [
'name' => [
'require',
'max' => 10
],
'price' => [
'number',
'between' => '1,100'
],
'email' => ['email']
];

数组模式是在规则复杂的时候使用

独立验证

上述的各种验证规则都需要调用validate目录下的验证器文件,而Think支持在控制器文件下独立验证;这种不依赖验证器文件的调用方式是一种独立、唯一的调用方式

namespace app\controller;
use think\facade\Validate;
class Verify
{
public function index()
{
$validate = Validate::rule([
'name' => 'require|max:20',
'price' => 'number|between:1,100',
'email' => 'email'
]);
$result = $validate->chech([
'name' => '蜡笔小新',
'price' => 90,
'email' => 'xiaoxin@qq.com'
]);
if (!$result){
dump($validate->getError());
}
}
}

独立验证支持对象化的定义方式,但不支持属性方法的定义:

namespace app\controller;
use think\facade\Validate;
use think\facade\ValidateRule as Rule;
class Verify
{
public function index()
{
$validate = Validate::rule([
'name' => 'Rule::isRequire()->max(20)',
'price' => 'Rule::isNumber()->between([1,100])',
'email' => 'Rule::isEmail()'
]);
$result = $validate->chech([
'name' => '蜡笔小新',
'price' => 90,
'email' => 'xiaoxin@qq.com'
]);
if (!$result){
dump($validate->getError());
}
}
}

独立验证支持闭包自定义方法:(不支持字段多规则)

$validate = Validate::rule([
'name'=> function($value){
return $value != '' ? true : '姓名不得为空';
},
'price'=> function($value){
return $value > 0 ? true:'不得低于零';
}
]);

错误信息

单独定义提示信息

在验证器类中定义message属性:

protected $message = [
'name.require' => '姓名不得为空',
'name.max' => '姓名不得大于20位',
'price.number' => '价格必须是数字',
'price.between' => '价格位于1~100之间',
'email' => '邮箱格式错误'
];

错误信息支持数组定义,并通过JSON方式交给前端

protected $message = [
'name.require' => ['code' => 1001, 'msg' => '名称必须'],
'name.max' => ['code' => 1002, 'msg' => '名称最多不能超过25个字符'],
'age.number' => ['code' => 1003, 'msg' => '年龄必须是数字'],
'age.between' => ['code' => 1004, 'msg' => '年龄必须在1~120之间'],
'email' => ['code' => 1005, 'msg' =>'邮箱格式错误'],
];

独立验证定义错误提示

ValidateRule::isEmail(null,'格式不正确')

参数一:验证规则

参数二:自定义错误提示

也可以独立使用message()方法:

Validate->[……]->message([……])

验证场景

验证场景设置:即特定的场景写是否进行验证,独立验证不存在场景验证;

新增数据需要验证邮箱信息,而修改数据不需要验证邮箱信息

namespace app\validate;
use think\Validate; class User extends Validate
{
protected $rule = [
'name' => 'require|max:20',
'price' => 'number|between:1,100',
'email' => 'email'
]; protected $message = [
'name.require' => '姓名不得为空',
'name.max' => '姓名不得大于20位',
'price.number' => '价格必须是数字',
'price.between' => '价格位于1~100之间',
'email' => '邮箱格式错误'
]; protected $scene = [
// 新增数据验证三个字段
'insert' => ['name','price','email'],
// 更新数据验证两个字段
'edit' => ['name','price']
];
}
try {
validate(User::class)->scene('edit')->check([
'name' => '蜡笔小新',
'price' => 90,
'email' => 'xiaoxinqq.com'
]);
} catch (ValidateException $err){
dump($err->getError());
}

在控制端设置scene()就成功的限制只验证nameprice两个字段

scene支持为单个场景单独定义方法,方法的命名规范是scene+场景名,采用驼峰写法;

同时在验证类中支持公共方法对场景中的细节进行定义:

public function sceneEdit()
{
return $this->only(['name','price'])
->append('name','min:5')
->remove('price','between')
->append('price','require|max:20');
}

append 追加

remove 移除

(不要对一个字段多次操作,会导致覆盖;可以同时操作)

only 约束字段

路由验证

路由验证:在路由参数调用验证类进行验证

protected $rule = [
'id' => 'number|between:1,10'
];
protected $message = [
'id.between' => 'id介于1~10之间',
'id.number' => 'id必须是数字'
];
protected $scene = [
'route' => ['id'];
];
Route::rule('vr/:id','Verify/route')->validate(User::class,'route');//只执行route场景

也支持使用独立的验证方式,这里不赘述……

内置规则

ThinkPHP6.0开发手册-内置规则

静态方法支持两种形式:::number()isNumber()方法验证

格式验证类

属性/方法 描述
require/::isRequire 不得为空
number/::isNumber 验证字段是否为纯数字
integer/::isInteger 验证字段是否为整数
float/::isFloat 验证字段是否为浮点数
boolean/::isBoolean 验证字段是否为布尔值
email/::isEmail 验证字段是否为邮箱格式
array/isArray 验证字段是否为数组
accepted/isAccepted 验证字段是否为yes/on
date/isDate 验证字段是否为有效日期
alpha/isAlpha 验证字段是否为纯字母
alphaNum/isAlphaNum 验证字段是否为纯字母数字组合
alphaDash/isAlphaDash 验证字段是否为字母数字下划线破折号组好
chs/isChs 验证字段是否为汉字
chsAlpha/isChsAlpha 验证字段是否为汉字字母
chsAlphaNum/isChsAlphaNum 验证字段是否为汉字字母和数字
chsDash/isChsDash 验证字段是否为字母数字下划线破折号组好和汉字
cntrl/isCntrl 验证字段是否为控制字符(空格、缩进)
graph/isGraph 验证字段是否为可打印字符(不包括空格)
print/isPrint 验证字段是否为可打印字符(包括空格)
lower/isLower 验证字段是否为小写
upper/isUpper 验证字段是否为大写
space/isSpace 验证字段是否为空白字符
xdigit/isXdigit 验证字段是否为十六进制
activeUrl/isActiveUrl 验证字段是否为有效域名
url/isUrl 验证字段是否为有效URL地址
ip/isIp 验证字段是否为有效IP地址
deteFormat:format 验证字段的日期时间格式
mobile 验证字段是否为有效手机号
idCard 验证身份证格式
macAddr 验证MAC地址格式
zip 验证有效邮政编码

长度和区间验证类

属性 描述
in 验证字段是否在某个范围
notIn 验证字段是否不再某个范围
between 验证字段是否在某个区间
notBetween 验证字段是否不在某个区间
length 验证长度是否在某个范围或指定长度
max/min 验证最大/最小长度(大小)
after 验证是否在某个日期之后
before 验证是否在某个日期之前
expire 验证当前值是否在某个时间区间内
allowip 验证当前值是否在某个IP段范围内
denyIp 验证当前值IP是否为禁止访问的IP

字段比较类

属性 描述
confirm:field 验证字段的值是否和其它的值一致
different:field 验证字段的值是否和其它的值不一致
eq/same/= 验证是否等于某个值
egt / >= 验证是否大于等于某个值
gt/> 验证是否大于某个值
elt/<= 验证是否小于等于某个值
lt/< 验证是否小于某个值

上传验证类

属性 描述
file 验证上传的是否是一个文件
image 验证是否是一个图像文件(可以约束width height type)
fileExt 验证文件后缀(可以允许后缀名单)
fileMime 验证文件类型(可以允许文件类型)
fileSize 验证文件大小(可以允许的字节大小)

其他验证类

filter验证:

支持使用filter_var进行验证,例如:

'ip'=>'filter:validate_ip'

正则验证:regex

支持使用正则表达式进行验证:

'data' => '\d{6}';
'data' => 'regex:\d{6}';

若表达式中包含或逻辑,需要使用数组方式定义

'data' => ['regex'=>'/^(yes|on|1)$/i']

同时也可以预定义

namespace app\index\validate;
use think\Validate;
class User extends Validate
{
protected $regex = [ 'zip' => '\d{6}']; protected $rule = [
'name' => 'require|max:25',
'email' => 'email',
];
}

然后就可以使用

'zip'	=>	'regex:zip',

表单令牌验证:token

参考连接:https://www.kancloud.cn/manual/thinkphp6_0/1037632

验证请求字段唯一:unique

可以验证当前请求的字段值是否为唯一的

unique:[table],[field],[except],[pk]

table:指定数据表

field:其他字段

except:排除某个主键值

pk:指定某个主键值排除

// 表示验证name字段的值是否在user表(不包含前缀)中唯一
'name' => 'unique:user',
// 验证其他字段
'name' => 'unique:user,account',
// 排除某个主键值
'name' => 'unique:user,account,10',
// 指定某个主键值排除
'name' => 'unique:user,account,10,user_id',

require:

属性 描述
requireIf:field,value 验证某个字段的值等于某个值的时候必须
requireWith:field 验证某个字段有值的时候必须
requireWithout:field 验证某个字段没有值的时候必须
requireCallback:callable 验证当某个callable为真时候字段必须

静态调用验证

静态调用:使用facade模式进行调用验证,适合验证单个数据

引入facade中的Validate时候可能会发生冲突,需要留意;

dump(Validate::isEmail('xiaoxin@qq.com'));

静态调用支持多规则验证:checkRule()

Validate::checkRule(10, 'number|between:1,10');

注解验证

参考官方:https://www.kancloud.cn/manual/thinkphp6_0/1375936

安装额外的扩展:

composer require topthink/think-annotation

ThinkPHP6.0学习笔记-验证器的更多相关文章

  1. ThinkPHP6.0学习笔记-模型操作

    ThinkPHP模型 模型定义 在app目录下创建Model目录,即可创建模型文件 定义一个和数据库表相匹配的模型 use think\Model; class User extends Model ...

  2. OAuth 2.0学习笔记

    文章目录 OAuth的作用就是让"客户端"安全可控地获取"用户"的授权,与"服务商提供商"进行互动. OAuth在"客户端&quo ...

  3. DirectX 总结和DirectX 9.0 学习笔记

    转自:http://www.cnblogs.com/graphics/archive/2009/11/25/1583682.html DirectX 总结 DDS DirectXDraw Surfac ...

  4. 一起学ASP.NET Core 2.0学习笔记(二): ef core2.0 及mysql provider 、Fluent API相关配置及迁移

    不得不说微软的技术迭代还是很快的,上了微软的船就得跟着她走下去,前文一起学ASP.NET Core 2.0学习笔记(一): CentOS下 .net core2 sdk nginx.superviso ...

  5. vue2.0学习笔记之路由(二)路由嵌套+动画

    <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8&quo ...

  6. vue2.0学习笔记之路由(二)路由嵌套

    <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8&quo ...

  7. hdcms v5.7.0学习笔记

    hdcms v5.7.0学习笔记 https://note.youdao.com/ynoteshare1/index.html?id=c404d63ac910eb15a440452f73d6a6db& ...

  8. dhtmlxgrid v3.0学习笔记

    dhtmlxgrid v3.0学习笔记 分类: dhtmlx JavaScript2012-01-31 15:41 1744人阅读 评论(0) 收藏 举报 stylesheetdatecalendar ...

  9. ThinkPHP6.0学习之安装及问题解决

    ThinkPHP6.0学习之安装及问题解决 ThinkPHP6.0开发版已经上线了,我已经等了他很久了,现在写一个系列来记录Thinkphp6.0的使用,我们现在从安装开始学习吧. 首先我们要确定Th ...

随机推荐

  1. Django之路由层和视图层详解

    路由层 首先我们来看一下,路由层都有哪些东西,其实你看django很人性化,将所有的介绍都放在了简介里面,不信,你看

  2. SpringBoot启动的时候出现log4j警告(配置文件找不到)

    SpringBoot启动的时候报如下的警告 在启动SpringBoot项目的时候,idea出现如下警告信息,也就是log4j 配置文件找不到的问题 log4j:WARN No appenders co ...

  3. Prism 源码解读3-Modules加载

    介绍 在软件开发过程中,总想组件式的开发方式,各个组件之间最好互不影响,独立测试.Prism的Modules很好的满足了这一点. 这个架构图很好了讲解了Prism的Modules的概念 Prism支持 ...

  4. shell脚本介绍以及常用命令

    Shell脚本 Shell Script,Shell脚本与Windows/Dos下的批处理相似,也就是用各类命令预先放入到一个文件中,方便一次性执行的一个程序文件,主要是方便管理员进行设置或者管理用的 ...

  5. 一篇文章让你了解动态数组的数据结构的实现过程(Java 实现)

    目录 数组基础简单回顾 二次封装数组类设计 基本设计 向数组中添加元素 在数组中查询元素和修改元素 数组中的包含.搜索和删除元素 使用泛型使该类更加通用(能够存放 "任意" 数据类 ...

  6. OpenCV-Python 直方图-4:直方图反投影 | 二十九

    目标 在本章中,我们将学习直方图反投影. 理论 这是由Michael J. Swain和Dana H. Ballard在他们的论文<通过颜色直方图索引>中提出的. 用简单的话说是什么意思? ...

  7. Android | 教你如何用华为HMS MLKit SDK 三十分钟在安卓上开发一个微笑抓拍神器

    Android | 只要三十分钟就可以在手机上开发一个微笑抓拍神器!!! 前言 前段时间Richard Yu在发布会上给大家介绍了华为HMS Core4.0,回顾发布会信息请戳: 华为面向全球发布HM ...

  8. css 动画 transition和animation

    本文参考:http://www.ruanyifeng.com/blog/2014/02/css_transition_and_animation.html 1. transition基本用法: < ...

  9. Unix 下 使用 RVM 管理 Ruby 和 gem

    转载:http://www.ibm.com/developerworks/cn/aix/library/au-aix-manage-ruby/   尽管 Internet Relay Chat.论坛和 ...

  10. SpringAOP入门

    Spring的AOP aop概述 Aspect Oriented Programing 面向切面(方面)编程, aop:扩展功能不修改源代码实现 aop采取横向抽取机制,取代了传统纵向继承体系重复性代 ...