yii框架之规则

   最近在学习php的yii框架，看到模块（model）这个文件下需要对属性做规则限定，但是自己没有接触过，就去百度整理了一下自己看到的一些解释，可以提供自己以后学习开发使用。

     预定义完整列表： 

• 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 的别名, 确保了特性是一个有效的路径 

     一下列出比较常见和使用的规则：

注：下列数组中第一个值和第二个值为必填项，message的值为错误提示信息

====================================================

1. reqiurd（CRequiredValidator）-----必须验证属性：

实例：array('name', 'required', 'requiredValue'=> '张', 'strict'=> true, 'message'=> '请填写姓名')

：

• requiredValue------mixed-----所需的值
• strict-------boolean------是否比较严格

====================================================

2. filter（CFilterValidator ）-----过滤验证方法：

实例：array('name', 'test', 'message'=> '请填写姓名')

     publicfunctiontest($object, $attributes) {

         if($this->name != '张先森') {

             $this->addError($object, $attributes['message']);

         }

     }

讲解：


• filte----方法名（调用用户自己定义的函数）

====================================================

3. match（CRegularExpressionValidator）-----正则验证属性：

实例：array('name', 'match', 'allowEmpty'=> 'true', 'not'=> 'true','pattern'=> '/[a-z]/i', 'message'=> '必须不是子母')

讲解：


• allowEmpty------boolean-----是否可以为空（默认为true）
• not-------boolean------是否反转验证逻辑
• pattern-------boolean------正则方法

====================================================

4. email（CEmailValidator）-----邮箱验证属性：

实例：array('name', 'email', 'allowEmpty'=> 'true','pattern'=> '/[a-z]/i', 'message'=> '必须不是子母')

讲解：


• allowEmpty------boolean-----是否可以为空（默认为true）
• pattern-------boolean------正则方法
• allowName-------boolean------是否允许在电子邮件地址的名称
• checkMx-------boolean------是否检查电子邮件地址的MX记录

====================================================

5. url（CUrlValidator）-----url验证属性：

实例：array('name', 'url', 'allowEmpty'=> 'true','pattern'=> '/[a-z]/i', 'message'=> '必须不是子母')

讲解：


• allowEmpty------boolean-----是否可以为空（默认为true）
• pattern-------boolean------正则方法
• defaultScheme-------boolean------默认的URL方案
• validSchemes-------boolean------清单应视为有效的URL计划

====================================================

6. unique（CUniqueValidator）-----唯一性验证属性：

实例：array('name', 'unique', 'allowEmpty'=> 'true','caseSensitive'=> 'true', 'message'=> '必须不是子母')

讲解：


• allowEmpty-----------是否可以为空（默认为true）
• caseSensitive-------------区分大小写

====================================================

7. compare（CCompareValidator）-----比较验证属性：

实例：

    与某个值比：array('name', 'compare', 'allowEmpty'=> 'true','compareValue'=> '10','operator'=> '>', 'message'=> '必须大于10')

    与某个提交的属性比：array('name', 'compare', 'allowEmpty'=> 'true','compareAttribute'=> 'password','operator'=> '>', 'message'=> '必须大于password')


讲解：


• allowEmpty-----------是否可以为空（默认为true）
• compareAttribute-------------需要比较的属性
• compareValue-------------需要比较的值
• operator-------------比较运算符
• strict-------------严格执行（值和类型都要相等）

====================================================

8. length（CStringValidator）-----字符串验证属性：

实例：

    是否在某个范围内：array('name', 'length', 'allowEmpty'=> 'true','max'=> '10','min'=> '5', 'tooLong'=> '太长了','tooShort'=> '太短了')

    必须是某个长度：array('name', 'length', 'is'=> '5', 'message'=> '长度必须为5')


讲解：


• allowEmpty-----------是否可以为空（默认为true）
• encoding-------------编码
• is-------------确切的长度
• max-------------最大长度
• min-------------最小长度
• tooLong-------------定义值太大的错误
• tooShort-------------定义值太大的错误

====================================================

9. in（CRangeValidator）-----在某个范围内属性：

实例：

    必须在某个范围内：array('name', 'in', 'range'=> array(1,2,3,4,5),'message'=> '值必须为1,2,3,4,5')

    不能在某个范围内：array('name', 'in','not'=> 'true', 'range'=> array(1,2,3,4,5),'message'=> '值不能为1,2,3,4,5')


讲解：


• allowEmpty-----------是否可以为空（默认为true）
• not-------------是否反转的验证逻辑
• range-------------array范围
• strict-------------严格执行（值和类型都要相等）

====================================================

10. numerical（CNumberValidator）-----数字验证属性：

实例：

    必须为整数：array('name', 'numerical', 'integerOnly'=> 'true', 'message'=> '值必须为整数')

    值必须在一个范围内：array('name', 'numerical', 'integerOnly'=> 'true', 'message'=> '值必须为整数', 'max'=> '100', 'min'=> '10','tooBig'=> '值太大了','tooSmall'=> '值太小了')

讲解：


• allowEmpty-----------是否可以为空（默认为true）
• integerOnly-------------整数
• integerPattern-------------正则表达式匹配整数
• max-------------最大值
• min-------------最小值
• numberPattern-------------匹配号码
• tooBig-------------值太大时的提示
• tooSmall-------------值太小时的提示

====================================================

11. captcha（CCaptchaValidator）-----验证码验证属性：

实例：array('name', 'captcha', 'caseSensitive'=> 'true', 'message'=> '验证码不正确')

讲解：


• allowEmpty-----------是否可以为空（默认为true）
• caseSensitive-------------区分大小写

====================================================

12. type（CTypeValidator）-----类型验证属性：

实例：array('name', 'type', 'dateFormat'=> 'MM/dd/yyyy', 'type'=> 'date', 'message'=> '类型不正确')

讲解：


• allowEmpty-----------是否可以为空（默认为true）
• dateFormat-------------日期应遵循的格式模式('MM/dd/yyyy')
• datetimeFormat-------------日期时间应遵循的格式模式('MM/dd/yyyy hh:mm')
  
• timeFormat-------------时间应遵循的格式模式('hh:mm')
• type-------------类型 ‘string’, ‘integer’, ‘float’, ‘array’, ‘date’, ‘time’, ‘datetime’

====================================================

13. file（CFileValidator）-----文件验证属性：

实例：array('name', 'file', 'types'=> array('jpg','gif','png'), 'message'=> '文件格式不正确')

讲解：


• allowEmpty-----------是否可以为空（默认为true）
• maxFiles-----------最大文件数
• maxSize-----------文件最大值
• minSize-----------文件最小值
• tooLarge-----------文件太大的错误信息
• tooMany-----------文件太多的错误信息
• tooSmall-----------文件太小的错误信息
• types-----------允许的扩展名
• wrongType-----------扩展名错误时的错误信息

====================================================

14. default（CDefaultValueValidator）-----默认值属性：

实例：array('name', 'default', 'setOnEmpty'=> 'true', 'value'=> '123')

讲解：


• setOnEmpty-----------设置为空
• value-----------默认值

====================================================

15. exist（CExistValidator）-----是否存在属性：

讲解：


• allowEmpty-----------是否可以为空（默认为true）
• attributeName-----------属性名称
• className-----------类名
• criteria-----------标准

====================================================

16. boolean（CBooleanValidator）-----布尔类型验证属性：

实例：array('name', 'boolean', 'trueValue'=> '1', 'falseValue'=> '-1','message'=> '该值只能为1或-1')

讲解：


• allowEmpty-----------是否可以为空（默认为true）
• falseValue-----------错误状态的值
• strict-----------严格验证
• trueValue-----------真实状态的值