Yii2.0中文开发向导—验证器(Validator)使用示例和详解

  •   
  • 2801
  • PHP
  • 0
  • super_dodo
  • 2017/05/02

在Model里面先看一下验证器的使用。最好是配合到attributeLabels。

	public function rules(){
		return [
			[['email', 'password'], 'required'],
			[['type','status', 'sort', 'view_count',], 'integer'],
			['password', 'string', 'min'=>6],
			[['name'], 'string', 'max' => 100],
			[['create_time', 'update_time'], 'safe'],
			[['url'], 'url'],
		];
	}


	public function attributeLabels(){
		return [
			'id' => 'ID',
			'email' => '邮箱',
			'name' => '名称',
			'status' => '状态 1正常 0停用',
			'sort' => '排序',
			//....
		];
	}

如上所示,验证器主要使用在rules里面,对当前model里面的属性值进行验证以检查是否满足某种要求。

验证器使用格式

书写格式为:[需要验证的属性,验证器名称,验证器参数]。

如果需要验证的属性为多个可用数组,如果为一个属性可用字符串也可用数组来表示。

每个属性都可以有多个验证器,如上面的password使用了 required和string两个验证器。

常用验证器

Yii2已经内置了一些常用的验证器。所有的验证器都从基类yii\validators\Validator继承实现。我大概总结下有这么几类。

数字相关

	integer——整数
	用来检测属性值是否为整数,以及最大、最小值检测等。(yii\validators\NumberValidator)
	double——浮点
	用来检测属性值是否为浮点数,即小数。(yii\validators\NumberValidator)
	number——数字
	这个和上面的double完全相同,只是用了2个名称。(yii\validators\NumberValidator)

格式相关

	date——日期
	检验属性值是否为正确的日期格式。(yii\validators\DateValidator)
	email——邮件
	检测属性值是否是正确的电子邮件格式。(yii\validators\EmailValidator)
	url——URL
	用来判断属性值是否是正确的url地址。(yii\validators\UrlValidator)

对值进行函数处理

	filter——过滤器
	这个是对属性值进行加工处理的。如对属性值加前缀、替换特定的字符串等等。(yii\validators\FilterValidator)
	trim——裁边
	这个是对属性值进行加工处理的。只是去掉字符串两侧的空格、或指定的字符串。(yii\validators\FilterValidator)

上传文件验证

	file——文件
	这个主要是对上传的文件进行验证,如格式、大小等。(yii\validators\FileValidator)
	image——图片
	这个和上面的file验证器差不多,不过是专门用来验证图片的。(yii\validators\ImageValidator)

判断比较

	compare——比较
	用来对两个属性值进行比较,如相等、大于、小于比较等。(yii\validators\CompareValidator)
	in——包含(范围)
	用来检测属性值是否包含在指定的数组中。(yii\validators\RangeValidator)
	exist——存在
	用来检测在数据表中是否已经存在此属性值。(yii\validators\ExistValidator)
	unique——唯一性
	这个和exist差不多,用来检测值是否是唯一。(yii\validators\UniqueValidator)
	string——字符串
	对属性值进行长度判断,如最大长度、最短长度等。(yii\validators\StringValidator)
	boolean——布尔型
	用来检查属性的值是否为布尔值。(yii\validators\BooleanValidator)
	default——默认值
	这个是用来给属性设置默认值的。如当属性值为null的时候,给它设置为 空的默认值。(yii\validators\DefaultValueValidator)
	required——必填
	这个用来检查属性值是否为空。(yii\validators\RequiredValidator)
	captcha——验证码
	这个主要是在界面使用验证码的时候对验证码进行验证的。(yii\captcha\CaptchaValidator)
	match——正则表达式
	这个就比较强大了,用来检测属性值是否匹配给出的正则。上面所列出的基本都可以用这个实现。(yii\validators\RegularExpressionValidator)

其它

	safe——安全
	这个不进行验证,仅仅用来指定属性值是安全的。(yii\validators\SafeValidator)

老当益壮,宁移白首之心?穷且益坚,不坠青云之志。