Yii2框架数据验证操作实例详解

本文实例讲述了Yii2框架数据验证操作。分享给大家供大家参考,具体如下:

一、场景

什么情况下需要使用场景呢?当一个模型需要在不同情境中使用时,若不同情境下需要的数据表字段和数据验证规则有所不同,则需要定义多个场景来区分不同使用情境。例如,用户注册的时候需要填写email,登录的时候则不需要,这时就需要定义两个不同场景加以区分。

认情况下模型的场景是由rules()方法申明的验证规则中使用到的场景决定的,也可以通过覆盖scenarios()方法来更具体地定义模型的所有场景,例如:

['username','email','password','conpassword','verifyCode','reg_time','log_time'],'login' => ['username','rememberMe','log_time'] ]; }

其中键为场景名称,值为该场景下使用的模型属性(称为活动属性)。

指定模型场景有以下两种方法

方法一:

scenario = 'signup';

方法二:

'signup']);

可以通过指定验证规则中的'on'属性来申明一条验证规则适用的场景:

'signup']

场景主要用于模型属性块赋值和数据验证。调用模型类的load()方法进行块赋值的时候,只有当前场景对应使用的属性会被赋值,调用模型类的validate()方法进行数据验证的时候,只有当前场景属性相关的且适用于当前场景的验证规则会被执行。

二、验证规则

Yii模型类通过实现rules()方法申明使用的所有验证规则,示例:

'signup'] ]; }

一条规则可适用于一个或多个场景,一条规则可用来验证一个或多个属性一个属性可对应一条或多条验证规则。如果没有指定'on'属性,验证规则会在所有场景下使用。

所有的验证规则都可以通过设置'message'属性自定义错误信息,而且在错误信息内容中可以通过{attribute}来引用当前属性标签名称属性标签名称需要在模型的attributeLabels()方法设置),通过{value}来引用当前属性的输入值,例如:

'register','message' => '{attribute}"{value}"已被占用!','on' => 'signup']//注册用户名唯一

yii验证的使用方式有以下三种:

1. 客户端验证:

Yii认开启客户端验证,可以通过设置enableClientValidation参数为true开启,开启之后ActiveForm会读取模型中申明的验证规则生成相应的Javascript验证代码。enableClientValidation参数设置的方式有三种:

(1)在视图文件ActiveForm中对整个form进行设置:

rush:PHP;"> true ]); ?>

(2)在视图文件ActiveField中对单个field进行设置:

代码如下:
field($model,'username',['enableClientValidation'=>false])->label('用户名') ?>

(3)在AR类的rules()函数中设置: 3,'max' => 30,'enableClientValidation' => true,'on' => 'register']

优先级:(2)>(1)>(3)

2. 服务器端验证:

(1)validate()

模型validate()方法会根据rules()方法中定义的验证规则对所有数据进行验证,验证通过返回true,否则将错误保存在属性中并返回false。

(2)save()

模型save()方法调用validate()方法进行数据验证,验证通过则直接进行数据库操作,返回true,否则不进行数据库操作,返回false,将错误信息存储在yii\base\Model::errors属性中。若已显式调用过validate(),可以通过传参避免在save()方法中重复验证数据:save(false)。

3. Ajax验证:

Yii关闭ajax验证,可以通过配置enableAjaxValidation参数为true开启。

客户端设置(两种方式):

(1)在视图文件ActiveForm中对整个form进行设置:

rush:PHP;"> true ]); ?>

(2)在视图文件ActiveField中对单个field进行设置:

代码如下:
field($model,['enableAjaxValidation'=>false])->label('用户名') ?>

优先级:(2)>(1)

服务器端处理:

request->isAjax) { $res = \yii\bootstrap\ActiveForm::validate($model); Yii::$app->response->format = \yii\web\Response::FORMAT_JSON; return $res; }

注:有些验证规则无法使用客户端验证,如:unique、exist等。

三、yii核心验证器

Yii提供了一些核心验证器,可以直接使用,申明格式如下:

属性名','验证器名称/类名',...(一些额外参数设置)]

了解并使用yii的核心验证器会让开发变得简单许多。下面简单对yii核心验证器进行分类介绍。

1. 不进行数据验证的验证器

(1)safe:而是把一个属性标记为安全属性

(2)default:给值为空的属性设置认值。

time()]

(3)trim:去除输入值首尾两侧多余空格。

(4)filter:滤镜,对数据进行格式化或一些其他处理后返回。

function($value) { ....return $value; }]

filter: 用于定义滤镜的PHP回调函数,可以为全局函数名,匿名函数或其他。 skipOnArray:是否在输入为数组时跳过滤镜,认为false。如果滤镜不能处理数组输入,应该设置为true。

2. 数据类型验证器

(1)boolean:布尔型。

true,'falseValue' => false,'strict' => true]

trueValue:代表真的值,认为1。 falseValue:代表假的值,认为0。 strict:是否要求输入数据必须严格匹配trueValue或falseValue。认为false。

(2)number:数字。

(3)double:双精度浮点型,等效于number验证器。

99.99,'min' => 0]

(4)integer:整数。

注:number、double、integer验证器都可以设置min、max参数来限制数字的最大、最小值(含界点)。

(5)string:字符串。

[3,30]]

length:指定输入字符串的长度限制。 min:字符串最小长度。 max:字符串最大长度。 encoding:字符串的编码方式,不设置则使用应用自身的charset属性值。认为utf-8。

3. 数据格式验证器

(1)date:日期。

'PHP:Y:m:d','timestampAttribute' => 'startTime']

format:时间格式,认为“y-m-d”。 timestampAttribute:将时间转化为时间戳并赋值给某个属性

(2)email:验证是否符合邮箱地址格式。

(3)ip:验证是否为有效IP地址。

(4)url:网址。

'http']

validSchemes:用于指定哪些URI方案会被视为有效,认为['http','https']。 defaultScheme:若输入值没有对应的方案前缀,会使用的认URI方案前缀。

(5)match:输入值是否满足某个正则表达式。

'/^[a-z]\w*$/i']

pattern:正则表达式。 not:是否对验证结果取反。

4. 数据值验证器

(1)required:必填。

required']

requiredValue:所期望的值,若没设置则输入不能为空。 strict:检查输入值时是否检查类型。

(2)captcha:验证码。

true,'captchaAction' => 'site/captcha','skipOnEmpty' => false]

caseSensitive:是否大小写敏感,认为false。 captchaAction:指向用于渲染验证码图片的captcha方法的路由,认为'site/captcha'。 skipOnEmpty:输入为空时是否跳过验证,认为false。

(3)compare:比较。

'conpassword','operator' => '==']

compareAttribute:与指定属性值比较的属性名称。 compareValue:与某个常量值比较。 operator:比较操作符。

其中compareAttribute认在验证属性后面加后缀“_repeat”作为另一个比较属性名称,operator认为“==”,即:['password','compare']规则表示验证password与password_repeat的值是否相等。

(4)each:验证数组。

['integer']]

(验证数组ids中的每个元素是否都是int类型数据) rule:定义验证每一个数组元素的验证规则。 allowMessageFromrule:是否使用rule中指定的多个验证规则报错信息,认为true,若设置为false,则使用“message”参数值作为错误信息。

注:若输入值不是数组则会报错。

(5)exist:存在性。

'app\models\Category','targetAttribute' => 'id']

(cid的值是否在AR类对应的id属性中存在,使用场景:当前AR模型关联的数据表的cid字段和Category模型关联的数据表的id字段相关联,所以使用该验证规则验证cid字段的值能否在关联的另一个数据表中找到对应记录) targetClass:用于查找输入值的目标AR类。 targetAttribute:用于查找输入值的目标属性名称。 filter:检查属性值存在性需要进行数据库查询,该参数设置查询的过滤条件。可以设置为查询条件的字符串或数组,或者function($query)匿名函数。 allowArray:是否允许输入值为数组,认为false。若设置为true,则数组的每个元素都必须在目标字段中存在。若把targetAttribute设置为多元素数组来验证被测值在多字段中的存在性时,该属性不能设置为true。

(6)unique:唯一性。

'app\models\User','message' => '{attribute}"{value}"已被注册!','on' => 'signup'] 除了没有allowArray属性,其他属性都和exist验证器一样。

(7)in:范围。

[0,1,2]]

range:范围值列表。 strict:是否使用严格模式(类型与值都要相同)。 not:是否对验证的结果取反,认为false。 allowArray:是否接受输入数组,认为false。

5. 文件验证器

(1)file:文件

['png','jpg','gif'],'maxSize' => 1024*1024]

extensions:可接受上传文件扩展名列表。 mimeTypes:可接受上传的MIME类型列表。 minSize:文件大小下限。 maxSize:文件大小上限。 maxFiles:上传文件个数上限,认为1。设置为大于1时输入值必须为数组。 checkExtensionByMimeType:是否通过文件的MIME类型来判断文件扩展,认为true。

(2)image:图片

'png,ipg','minWidth' => 100,'minHeight' => 100]

该验证器继承自file验证器,并支持额外属性minWidth、maxWidth、minHeight、maxHeight来设置图片的最小、最大宽度和最小、最大高度。

四、其他验证器

1. 条件式验证:

function($model) {//只在country属性值为'USA'的时候state属性值才不能为空 return $model->country=='USA'; }]

注:若需要支持客户端验证,则要配置'whenClient'属性

1. 自定义验证器:

(1)行内验证器:一种以模型方法或匿名函数的形式定义的验证器。

示例:

$attribute != $this->newpassword) { $this->addError($attribute,'确认密码和新密码不一致!'); } }]。

(当然这里也可以使用yii核心验证器'compare'来实现)

注:行内验证器不支持客户端验证。

(2)独立验证器:

独立验证器是继承自yii\validators\Validator或其子类的类,可以通过重写validateAttribute()方法来实现验证规则,若验证失败,可以调用yii\base\Model::addError()方法来保存错误信息到模型内。

独立验证器示例:

message = '确认密码和密码不一致!'; } //服务器端验证 public function validateAttribute($model,$attribute) { if($model->conpassword !== $model->password) { $model->addError($attribute,$this->message); } } //客户端验证 public function clientValidateAttribute($model,$attribute,$view) { $conpassword = json_encode($model->conpassword); $message = json_encode($this->message,JSON_UnesCAPED_SLASHES | JSON_UnesCAPED_UNICODE); return <<

模型中使用示例:

最后要注意,验证规则申明的先后顺序对验证结果也是有影响的!

更多关于Yii相关内容感兴趣的读者可查看本站专题:《》、《》、《》、《》、《》、《》及《PHP常见数据库操作技巧汇总》

希望本文所述对大家基于Yii框架的PHP程序设计有所帮助。

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


服务器优化必备:深入了解PHP8底层开发原理
Golang的网络编程:如何快速构建高性能的网络应用?
Golang和其他编程语言的对比:为什么它的开发效率更高?
PHP8底层开发原理揭秘:如何利用新特性创建出色的Web应用
将字符重新排列以形成回文(如果可能)在C++中
掌握PHP8底层开发原理和新特性:创建高效可扩展的应用程序
服务器性能优化必学:掌握PHP8底层开发原理
PHP8新特性和底层开发原理详解:优化应用性能的终极指南
将 C/C++ 代码转换为汇编语言
深入研究PHP8底层开发原理:创建高效可扩展的应用程序
C++程序查找法向量和迹
PHP8底层开发原理实战指南:提升服务器效能
重排数组,使得当 i 为偶数时,arr[i] >= arr[j],当 i 为奇数时,arr[i] <= arr[j],其中 j < i,使用 C++ 语言实现
Golang的垃圾回收:为什么它可以减少开发人员的负担?
C++程序:将一个数组的所有元素复制到另一个数组中
Golang:构建智能系统的基石
为什么AI开发者应该关注Golang?
在C和C++中,逗号(comma)的用法是用来分隔表达式或语句
PHP8底层开发原理解析及新特性应用实例
利用PHP8底层开发原理解析新特性:如何构建出色的Web应用