验证规则

版本	新增功能
5.0.4	支持传入field参数批量设置验证字段的描述信息

设置规则

可以在实例化Validate类的时候传入验证规则，例如：

						$rules = [
							'name'
							=>
							'require|max:25',
							'age'
							=>
							'number|between:1,120', ]; $validate =
							new
							Validate($rules);
						
					

也可以使用rule方法动态添加规则，例如：

						$rules = [
							'name'
							=>
							'require|max:25',
							'age'
							=>
							'number|between:1,120', ]; $validate =
							new
							Validate($rules); $validate->rule('zip',
							'/^\d{6}$/'); $validate->rule([
							'email'
							=>
							'email', ]);
						
					

规则定义

规则定义支持下面两种方式：

						$rules = [
							'name'
							=>
							'require|max:25',
							'age'
							=>
							'number|between:1,120', ]; $validate =
							new
							Validate($rules);
						
					

对于一个字段可以设置多个验证规则，使用|分割。

或者采用数组方式定义多个规则（适用于你的验证规则中有|的情况）

						$rules = [
							'name'
							=> ['require','max'=>25],
							'age'
							=> ['number','between'=>'1,120'], ]; $validate =
							new
							Validate($rules);
						
					

属性定义

通常情况下，我们实际在定义验证类的时候，可以通过属性的方式直接定义验证规则等信息，例如：

						
							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'
							=>
							'邮箱格式错误',         ];      }
						
					

验证数据

下面是一个典型的验证数据的例子：

						$rule = [
							'name'
							=>
							'require|max:25',
							'age'
							=>
							'number|between:1,120',
							'email'
							=>
							'email', ];  $msg = [
							'name.require'
							=>
							'名称必须',
							'name.max'
							=>
							'名称最多不能超过25个字符',
							'age.number'
							=>
							'年龄必须是数字',
							'age.between'
							=>
							'年龄只能在1-120之间',
							'email'
							=>
							'邮箱格式错误', ];  $data = [
							'name'
							=>
							'thinkphp',
							'age'
							=>
							10,
							'email'
							=>
							'[email protected]', ];  $validate =
							new
							Validate($rule, $msg); $result   = $validate->check($data);
						
					

如果需要批量验证，可以使用：

						$validate =
							new
							Validate($rule, $msg); $result   = $validate->batch()->check($data);
						
					

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

如果你定义了User验证器类的话，可以使用下面的验证代码：

						$data = [
							'name'
							=>
							'thinkphp',
							'age'
							=>
							10,
							'email'
							=>
							'[email protected]', ]; $validate = Loader::validate('User');
							if(!$validate->check($data)){     dump($validate->getError()); }
						
					

闭包函数验证

可以对某个字段使用闭包验证，例如：

						$validate =
							new
							\think\Validate([
							'name'
							=>
							
								function
								($value,$data)
							{
							return
							'thinkphp'==$value ?
							true
							:
							false;     }, ]);
						
					

第一个参数是当前字段的值，第二个参数是全部数据

自定义验证规则

系统内置了一些常用的规则，如果还不够用，可以自己扩展验证规则。

如果使用了验证器的话，可以直接在验证器类添加自己的验证方法，例如：

						
							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个（后面三个根据情况选用），依次为：

• 验证数据
• 验证规则
• 全部数据（数组）
• 字段名
• 字段描述

并且需要注意的是，自定义的验证规则方法名不能和已有的规则冲突。

接下来，就可以这样进行验证：

						$validate = Loader::validate('User');
							if(!$validate->check($data)){     dump($validate->getError()); }
						
					

如果没有使用验证器类，则支持使用extend方法扩展验证规则，例如：

						$validate =
							new
							Validate(['name'
							=>
							'checkName:1']); $validate->extend('checkName',
							
								function
								($value, $rule)
							{
							return
							$rule == $value ?
							true
							:
							'名称错误'; }); $data   = ['name'
							=>
							1]; $result = $validate->check($data);
						
					

支持批量注册验证规则，例如：

						$validate =
							new
							Validate(['name'
							=>
							'checkName:1']); $validate->extend([
							'checkName'=>
							
								function
								($value, $rule)
							{
							return
							$rule == $value ?
							true
							:
							'名称错误'; },
							'checkStatus'=> [$this,'checkStatus'] ]); $data   = ['name'
							=>
							1]; $result = $validate->check($data);
						
					

设置字段信息

V5.0.4+版本开始，验证类的架构方法支持传入field参数批量设置字段的描述信息，例如：

						$rule = [
							'name'
							=>
							'require|max:25',
							'age'
							=>
							'number|between:1,120',
							'email'
							=>
							'email', ];  $field = [
							'name'
							=>
							'名称',
							'age'
							=>
							'年龄',
							'email'
							=>
							'邮箱',	 ];  $data = [
							'name'
							=>
							'thinkphp',
							'age'
							=>
							10,
							'email'
							=>
							'[email protected]', ];  $validate =
							new
							Validate($rule, [] , $field); $result   = $validate->check($data);