TP框架中的自动验证功能$_validate

Thinkphp 中$_validate 关键字是在模型中定义的自动验证数据的功能。验证的规则可以是进行数据类型、业务规则、安全判断等方面的验证操作。

数据验证有两种方式：

1. 静态方式：在模型类里面通过$_validate属性定义验证规则。
2. 动态方式：使用模型类的validate方法动态创建自动验证规则。 

无论是什么方式，验证规则的定义是统一的规则，定义格式为：

[php]  view plain  copy

1. array(  
2.      array(验证字段1,验证规则,错误提示,[验证条件,附加规则,验证时间]),   
3.      array(验证字段2,验证规则,错误提示,[验证条件,附加规则,验证时间]),   
4.     ......);  

说明

参数一：验证字段 （必须）

需要验证的表单字段名称，这个字段不一定是数据库字段，也可以是表单的一些辅助字段，例如确认密码和验证码等等。有个别验证规则和字段无关的情况下，验证字段是可以随意设置的，例如expire有效期规则是和表单字段无关的。如果定义了字段映射的话，这里的验证字段名称应该是实际的数据表字段而不是表单字段。

参数二：验证规则 （必须）

要进行验证的规则，需要结合附加规则，如果在使用正则验证的附加规则情况下，系统还内置了一些常用正则验证的规则，可以直接作为验证规则使用，包括：require 字段必须、email 邮箱、url URL地址、currency 货币、number 数字。

参数三：提示信息 （必须）

用于验证失败后的提示信息定义

参数四：验证条件 （可选）

包含下面几种情况：

• self::EXISTS_VALIDATE   或者     0   表示只有字段存在时验证（默认）
• self::MUST_VALIDATE     或者     1   表示无论有无字段都必须验证
• self::VALUE_VALIDATE   或者      2  表示字段值不是为空（即有填数据）的时候就验证 

参数五：附加规则 （可选）

配合 参数二 验证规则使用，包括下面一些规则：

规则	说明
regex	正则验证，定义的验证规则是一个正则表达式（默认）
function	函数验证，定义的验证规则是一个函数名
callback	方法验证，定义的验证规则是当前模型类的一个方法
confirm	验证表单中的两个字段是否相同，定义的验证规则是一个字段名
equal	验证是否等于某个值，该值由前面的验证规则定义
notequal	验证是否不等于某个值，该值由前面的验证规则定义（3.1.2版本新增）
in	验证是否在某个范围内，定义的验证规则可以是一个数组或者逗号分割的字符串
notin	验证是否不在某个范围内，定义的验证规则可以是一个数组或者逗号分割的字符串（3.1.2版本新增）
length	验证长度，定义的验证规则可以是一个数字（表示固定长度）或者数字范围（例如3,12 表示长度从3到12的范围）
between	验证范围，定义的验证规则表示范围，可以使用字符串或者数组，例如1,31或者array(1,31)
notbetween	验证不在某个范围，定义的验证规则表示范围，可以使用字符串或者数组（3.1.2版本新增）
expire	验证是否在有效期，定义的验证规则表示时间范围，可以到时间，例如可以使用 2012-1-15,2013-1-15 表示当前提交有效期在2012-1-15到2013-1-15之间，也可以使用时间戳定义
ip_allow	验证IP是否允许，定义的验证规则表示允许的IP地址列表，用逗号分隔，例如201.12.2.5,201.12.2.6
ip_deny	验证IP是否禁止，定义的验证规则表示禁止的ip地址列表，用逗号分隔，例如201.12.2.5,201.12.2.6
unique	验证是否唯一，系统会根据字段目前的值查询数据库来判断是否存在相同的值，当表单数据中包含主键字段时unique不可用于判断主键字段本身

参数六：验证时间（可选）

• self::MODEL_INSERT    或者    1 表示新增（添加时）数据时候就验证
• self::MODEL_UPDATE  或者     2 表示编辑（修改时）数据时候就验证
• self::MODEL_BOTH       或者     3 全部情况下（在添加数据和编辑时）都验证（默认）

这里的验证时间需要注意，并非只有这三种情况，你可以根据业务需要增加其他的验证时间，例如：

其中，对create数据的设置是这样  ：$M -> create($_POST,4)；

静态定义

在模型类里面预先定义好该模型的自动验证规则，我们称为静态定义。

举例说明，我们在模型类里面定义了$_validate属性如下：

[php]  view plain  copy

1. namespace Home\Model;  
2. use Think\Model;  
3. class UserModel extends Model{  
4.    protected $_validate = array(  
5.      array('verify','require','验证码必须！'),                     // 默认情况下用正则进行验证  
6.      array('name','','帐号名称已经存在！',0,'unique',1),           // 在添加数据时(参6为1)验证name字段是否唯一，参4为0表示可以有存在字段就验证       
7.      array('value',array(1,2,3),'值的范围不正确！',2,'in'),        // 当(参4)值不是为空的时候就判断是否在一个范围内  
8.      array('repassword','password','确认密码不正确',0,'confirm'),  // 验证确认密码是否和密码一致  
9.      array('password','checkPwd','密码格式不正确',0,'function'),   // 自定义函数验证密码格式  
10.    );}  

定义好验证规则后，就可以在使用create方法创建数据对象的时候自动调用：

[php]  view plain  copy

1. $User = D("User"); // 实例化User对象  
2. if (!$User->create()){  
3.      // 如果创建失败 表示验证没有通过 输出错误提示信息  
4.      exit($User->getError());  
5.  }else{  
6.    // 验证通过 可以进行其他数据操作  
7. }  

在进行自动验证的时候，系统会对定义好的验证规则进行依次验证。如果某一条验证规则没有通过，则会报错，getError方法返回的错误信息（字符串）就是对应字段的验证规则里面的错误提示信息。

静态定义方式因为必须定义模型类，所以只能用D函数实例化模型。

默认情况下，create方法是对表单提交的POST数据进行自动验证，如果你的数据来源不是表单post，仍然也可以进行自动验证，方法改进如下：

[php]  view plain  copy

1. $User = D("User"); // 实例化User对象  
2. $data = getData(); // 通过getData方法获取数据源的（数组）数据  
3. if (!$User->create($data)){  
4.      // 对data数据进行验证  
5.           exit($User->getError());  
6.       }else{  
7.            // 验证通过 可以进行其他数据操作  
8.        }  

一般情况下，create方法会自动判断当前是新增数据还是编辑数据（主要是通过表单的隐藏数据添加主键信息），你也可以明确指定当前创建的数据对象是新增还是编辑，例如：

[php]  view plain  copy

1. </pre><pre name="code" class="php">$User = D("User"); // 实例化User对象  
2. if (!$User->create($_POST,1)){ // 指定新增数据  
3.      // 如果创建失败 表示验证没有通过 输出错误提示信息   
4.     exit($User->getError());  
5.  }else{  
6.       // 验证通过 可以进行其他数据操作  
7.   }  

create方法的第二个参数就用于指定自动验证规则中的验证时间，也就是说create方法的自动验证只会验证符合验证时间的验证规则。

我们在上面提到这里的验证时间并非只有这几种情况，你可以根据业务需要增加其他的验证时间，例如，你可以给登录操作专门指定验证时间为4。我们定义验证规则如下：