加载中...

快速入门 19：自动验证

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();
}
还没有评论.