PHP YII框架开发小技巧之模型(models)中rules自定义验证规则


Posted in PHP onNovember 16, 2015

YII的models中的rules部分是一些表单的验证规则,对于表单验证十分有用,在相应的视图(views)里面添加了表单,在表单被提交之前程序都会自动先来这里面的规则里验证,只有通过对其有效的限制规则后才能被提交,可以很有效地保证表单安全和信息的有效性。还是给大家具体说明一下:

以下是视图(views)部分的简单代码:

<?php $form=$this->beginWidget('CActiveForm', array( 
  'id'=>'tag-form', 
  'enableAjaxValidation'=>false, 
)); ?> 
  <div class="row"> 
    <?php echo $form->labelEx($model,'tagname'); ?> 
    <?php echo $form->textField($model,'tagname',array('size'=>20,'maxlength'=>32)); ?> 
  </div> 
  <div class="row"> 
    <?php echo $form->labelEx($model,'tagtype'); ?> 
    <?php echo $form->radioButtonList($model,'tagtype'array(1=>"普通TAG",2=>"系统默认TAG"),array('separator'=>'','labelOptions'=>array('class'=>'tagtypelabel'))); ?> 
  </div> 
  <?php echo $form->errorSummary($model); ?> 
  <div class="row buttons"> 
    <?php echo CHtml::submitButton($model->isNewRecord ? '添加' : '修改'); ?> 
  </div> 
<?php $this->endWidget(); ?>

模型(models)中rules部分的简单代码:

public function rules() 
{ 
  return array( 
    array('tagname,tagtype', 'required'), 
    array('tagtype', 'numerical', 'integerOnly'=>true), 
    array('tagname', 'length', 'max'=>32), 
    array('tagname', 'match', 'pattern'=>'/^[\x{4e00}-\x{9fa5}A-Za-z0-9]+$/u', 
        'message'=>'标签不合法,必须为汉字、字母或者数字!'), 
    array('tagname', 'checktagname', 'on'=>'create,update'),//插入TAG时检查是否已经存在该tag 
    array('tagid, tagname, tagtype', 'safe', 'on'=>'search'), 
  ); 
}

系统默认有这些验证规则:

boolean : CBooleanValidator 的别名, 确保属性的值是CBooleanValidator::trueValue 或 CBooleanValidator::falseValue . 
captcha : CCaptchaValidator 的别名,确保了特性的值等于 CAPTCHA 显示出来的验证码. 
compare : CCompareValidator 的别名, 确保了特性的值等于另一个特性或常量. 
email : CEmailValidator 的别名,确保了特性的值是一个有效的电邮地址. 
default : CDefaultValueValidator 的别名, 为特性指派了一个默认值. 
exist : CExistValidator 的别名, 确保属性值存在于指定的数据表字段中. 
file : CFileValidator 的别名, 确保了特性包含了一个上传文件的名称. 
filter : CFilterValidator 的别名, 使用一个filter转换属性. 
in : CRangeValidator 的别名, 确保了特性出现在一个预订的值列表里. 
length : CStringValidator 的别名, 确保了特性的长度在指定的范围内. 
match : CRegularExpressionValidator 的别名, 确保了特性匹配一个正则表达式. 
numerical : CNumberValidator 的别名, 确保了特性是一个有效的数字. 
required : CRequiredValidator 的别名, 确保了特性不为空. 
type : CTypeValidator 的别名, 确保了特性为指定的数据类型. 
unique : CUniqueValidator 的别名, 确保了特性在数据表字段中是唯一的. 
url : CUrlValidator 的别名, 确保了特性是一个有效的路径.

基本上还是比较全面的,一般的都够用了,但是还是有时候有的验证需要自定义。就以上面的代码为例,我们在添加TAG时需要检查系统之前是否已经存在这个TAG,如果存在则不让用户添加。这个就需要在添加之前去查询数据库,看该TAG是否已经存在,这里我们就需要自定一个验证规则了。

关键有一下两个步骤:

1、在rules中 添加代码:array('tagname', 'checktagname', 'on'=>'create,update'),//插入TAG时检查是否已经存在该tag

注:我在其中用了 'on'=>'create,update',所以这个验证规则之对create,update场景生效

2、在该模型(models)中添加验证函数:

public function checktagname($attribute,$params){ 
  $oldtag = Tag::model()->findByAttributes(array('tagname'=>$this->tagname)); 
  if($oldtag->tagid > 0){ 
    $this->addError($attribute, '该TAG已经存在!'); 
  } 
}

其中需要说明的是:

(1)该验证函数的参数必须是($attribute,$params),不能缺少其中任何一个;

(2)$this->addError($attribute, '该TAG已经存在!');这个是你想要在视图中输出的错误提示信息。

就是这么简单,有了这个方法,表单验证的各种想要的规则就都可以自定义了。

下面给大家介绍Yii自定义验证规则

最简单的定义验证规则的方法是在使用它的模型(model)内部定义。

比方说,你要检查用户的密码是否足够安全.

通常情况下你会使用 CRegularExpression 方法验证,但为了本指南,我们假设不存在此验证方法.

首先在模型(model)中添加两个常量

const WEAK = 0;
const STRONG = 1;然后在模型(model)的 rules 方法中设置:

/**
 * @return array validation rules for model attributes.
 */
public function rules()
{
  return array(
    array('password', 'passwordStrength', 'strength'=>self::STRONG),
  );
}

确保你写的规则不是一个已经存在的规则,否则将会报错.

现在要做的是在模型(model)中创建一个名称为上面填写的规则的方法(即 passwordStrength)。

/**
 * check if the user password is strong enough
 * check the password against the pattern requested
 * by the strength parameter
 * This is the 'passwordStrength' validator as declared in rules().
 */
public function passwordStrength($attribute,$params)
{
  if ($params['strength'] === self::WEAK)
    $pattern = '/^(?=.*[a-zA-Z0-9]).{5,}$/'; 
  elseif ($params['strength'] === self::STRONG)
    $pattern = '/^(?=.*\d(?=.*\d))(?=.*[a-zA-Z](?=.*[a-zA-Z])).{5,}$/'; 
    
  if(!preg_match($pattern, $this->$attribute))
   $this->addError($attribute, 'your password is not strong enough!');
}

刚才创建的方法需要两个参数:* $attribute 需要验证的属性* $params 在规则中自定义的参数

在模型的 rules 方法中我们验证的是 password 属性,所以在验证规则中需要验证的属性值应该是 password.

在 rules 方法中我们还设置了自定义的参数 strength,它的值将会放到 $params 数组中.

你会发现在方法中我们使用了 CModel::addError().

添加错误接受两个参数:第一个参数是在表单中显示错误的属性名,第二个参数时显示的错误信息 。

完整的方法:继承 CValidator 类

如果你想把规则使用在多个模型(model)中,最好的方法时继承 CValidator 类。

继承这个类你可以使用像 CActiveForm::$enableClientValidation (Yii 1.1.7 版本后可用) 类似的其他功能。

创建类文件

首先要做的是创建类文件.最好的方法时类的文件名和类名相同,可以使用 yii 的延迟加载(lazy loading)功能。

让我们在应用(application)的扩展(extensiions)目录(在 protected 文件夹下)下新建一个文件夹.

将目录命名为: MyValidators

然后创建文件: passwordStrength.php

在文件中创建我们的验证方法

class passwordStrength extends CValidator
{
  public $strength;
  private $weak_pattern = '/^(?=.*[a-zA-Z0-9]).{5,}$/';
  private $strong_pattern = '/^(?=.*\d(?=.*\d))(?=.*[a-zA-Z](?=.*[a-zA-Z])).{5,}$/';
...
}

在类中创建属性,此属性为在验证规则中使用的参数.

CValidator 会自动根据参数来填充这些属性.

我们也创建了两个其他的属性,它们为 preg_match 函数使用的正则表达式.

现在我们应该重写父类的抽象方法(abstract method) validateAttribute

/**
 * Validates the attribute of the object.
 * If there is any error, the error message is added to the object.
 * @param CModel $object the object being validated
 * @param string $attribute the attribute being validated
 */
protected function validateAttribute($object,$attribute)
{
  // check the strength parameter used in the validation rule of our model
  if ($this->strength == 'weak')
   $pattern = $this->weak_pattern;
  elseif ($this->strength == 'strong')
   $pattern = $this->strong_pattern;
  // extract the attribute value from it's model object
  $value=$object->$attribute;
  if(!preg_match($pattern, $value))
  {
    $this->addError($object,$attribute,'your password is too weak!');
  }
}

上面的方法我认为就不用解释了.当然你也可以在 if 的条件中使用常量,我推荐使用.

PHP 相关文章推荐
C# Assembly类访问程序集信息
Jun 13 PHP
PHP 内存缓存加速功能memcached安装与用法
Sep 03 PHP
PHP以及MYSQL日期比较方法
Nov 29 PHP
Smarty模板学习笔记之Smarty简介
May 20 PHP
php异步:在php中使用fsockopen curl实现类似异步处理的功能方法
Dec 10 PHP
关于Laravel Route重定向的一个注意点
Jan 16 PHP
深入理解Yii2.0乐观锁与悲观锁的原理与使用
Jul 26 PHP
浅谈php的TS和NTS的区别
Mar 13 PHP
php新建文件的方法实例
Sep 26 PHP
php使用fputcsv实现大数据的导出操作详解
Feb 27 PHP
PHP实现基本留言板功能原理与步骤详解
Mar 26 PHP
php设计模式之组合模式实例详解【星际争霸游戏案例】
Mar 27 PHP
PHP Yii框架之表单验证规则大全
Nov 16 #PHP
Yii2.0高级框架数据库增删改查的一些操作
Nov 16 #PHP
yii添删改查实例
Nov 16 #PHP
PHP的运行机制与原理(底层)
Nov 16 #PHP
PHP中empty和isset对于参数结构的判断及empty()和isset()的区别
Nov 15 #PHP
php经典算法集锦
Nov 14 #PHP
PHP常用的小程序代码段
Nov 14 #PHP
You might like
修改destoon会员公司的伪静态中的com目录的方法
2014/08/21 PHP
Yii核心组件AssetManager原理分析
2014/12/02 PHP
部署PHP时的4个配置修改说明
2015/10/19 PHP
分享PHP守护进程类
2015/12/30 PHP
ThinkPHP5&amp;5.1实现验证码的生成、使用及点击刷新功能示例
2020/02/07 PHP
asp javascript 实现关闭窗口时保存数据的办法
2007/11/24 Javascript
Javascript 学习书 推荐
2009/06/13 Javascript
safari,opera嵌入iframe页面cookie读取问题解决方法
2010/06/23 Javascript
js下用eval生成JSON对象
2010/09/17 Javascript
关于jquery.validate1.9.0前台验证的使用介绍
2013/04/26 Javascript
jQuery实现倒计时按钮功能代码分享
2014/09/03 Javascript
jquery拖拽排序简单实现方法(效果增强版)
2016/02/16 Javascript
JavaScript实现页面跳转的方式汇总
2016/05/16 Javascript
JavaScript Uploadify文件上传实例
2017/02/28 Javascript
详解如何在React组件“外”使用父组件的Props
2018/01/12 Javascript
Egg.js 中 AJax 上传文件获取参数的方法
2018/10/10 Javascript
ES6对象操作实例详解
2020/05/23 Javascript
实现一个Vue自定义指令懒加载的方法示例
2020/06/04 Javascript
JavaScript实现五子棋小游戏
2020/10/26 Javascript
swiperjs实现导航与tab页的联动
2020/12/13 Javascript
python生成随机验证码(中文验证码)示例
2014/04/03 Python
Python字符串中查找子串小技巧
2015/04/10 Python
Django中的CACHE_BACKEND参数和站点级Cache设置
2015/07/23 Python
PyQt QCombobox设置行高的方法
2019/06/20 Python
python实现中文文本分句的例子
2019/07/15 Python
python PyAutoGUI 模拟鼠标键盘操作和截屏功能
2019/08/04 Python
python3中pip3安装出错,找不到SSL的解决方式
2019/12/12 Python
python实现批量处理将图片粘贴到另一张图片上并保存
2019/12/12 Python
在django中实现choices字段获取对应字段值
2020/07/12 Python
请说出几个常用的异常类
2013/01/08 面试题
银行会计财务工作个人的自我评价
2013/10/29 职场文书
财务会计专业推荐信
2013/11/30 职场文书
高分子材料与工程专业个人求职信
2013/12/15 职场文书
2015年班干部工作总结
2015/04/29 职场文书
反腐倡廉主题教育活动总结
2015/05/07 职场文书
CSS SandBox应用场景及常见问题
2022/06/25 HTML / CSS