快速入门 19：自动验证
最后更新于：2022-04-01 00:18:56
# 快速入门（十九）：自动验证
ThinkPHP的模型可以支持数据自动验证功能，用于验证提交到数据库的数据的有效性和安全性。
> 该自动验证为后端验证，并非前端验证。
可以支持两种方式的自动验证，包括静态验证和动态验证。
## 静态验证
静态验证是指把验证的规则直接定义在模型类里面，也就是说，这种验证必须有自定义的模型类存在，假设我们的用户注册表单如下：
~~~
<form method="post" action="/user/register">
<input type="text" name="name" >
<input type="text" name="email" >
<input type="password" name="password" >
<input type="password" name="repassword" >
<img height="42" src="/user/verify" >
<input name="verify" type="text" maxlength="4">
</form>
~~~
我们需要对用户注册表单进行一些相关的验证操作，包括：
> 用户名必须；
> 验证码用户名是否已经存在；
> 如果输入邮箱则验证邮箱格式是否正确；
> 验证密码是否为指定长度；
> 确认密码是否和密码一致；
按照上述的验证规则，我们定义好自动验证规则，为UserModel类添加 `$_validate` 属性定义如下：
~~~
namespace Home\Model;
use Think\Model;
class UserModel extends Model{
protected $_validate = array(
array('name','require','用户名必须！'), // 用户名必须
array('name','','帐号名称已经存在！',1,'unique',1), // 验证用户名是否已经存在
array('email','email','Email格式错误！',2), // 如果输入则验证Email格式是否正确
array('password','6,30','密码长度不正确',0,'length'), // 验证密码是否在指定长度范围
array('repassword','password','确认密码不一致',0,'confirm'), // 验证确认密码是否和密码一致
);
}
~~~
定义好自动验证规则后，我们就可以在控制器使用create方法进行自动验证了。
~~~
$User = D("User"); // 实例化User对象
if (!$User->create()){
// 如果创建失败 表示验证没有通过 输出错误提示信息
exit($User->getError());
}else{
// 验证通过 可以进行其他数据操作
$User->add();
}
~~~
在进行自动验证的时候，系统会对定义好的验证规则进行依次验证。对于某个字段也可以进行多次规则验证，如果某一条验证规则没有通过，则会报错，getError方法返回的错误信息（字符串）就是对应字段的验证规则里面的错误提示信息。
## 验证规则
验证规则的定义格式为：
~~~
array(验证字段1,验证规则,错误提示,[验证条件,附加规则,验证时间]),
~~~
##### 验证字段 （必须）
需要验证的表单字段名称，这个字段不一定是数据库字段，也可以是表单的一些辅助字段，例如确认密码和验证码等等。有个别验证规则和字段无关的情况下，验证字段是可以随意设置的，例如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全部情况下验证（默认）
这里的验证时间需要注意，并非只有这三种情况，你可以根据业务需要增加其他的验证时间。
## 动态验证
如果采用动态验证的方式，因为不依赖模型类的定义，就比较灵活，可以根据不同的需要，在操作同一个模型的时候使用不同的验证规则，而且可以直接使用M函数操作模型类，例如上面的静态验证方式可以改为：
~~~
$rules = array(
array('name','require','用户名必须！'), // 用户名必须
array('name','','帐号名称已经存在！',1,'unique',1), // 验证用户名是否已经存在
array('email','email','Email格式错误！',2), // 如果输入则验证Email格式是否正确
array('password','6,30','密码长度不正确',0,'length'), // 验证密码是否在指定长度范围
array('repassword','password','确认密码不一致',0,'confirm'), // 验证确认密码是否和密码一致
);
$User = M("User"); // 实例化User对象
if (!$User->validate($rules)->create()){
// 如果创建失败 表示验证没有通过 输出错误提示信息
exit($User->getError());
}else{
// 验证通过 可以进行其他数据操作
$User->add();
}
~~~