ThinkPHP 自动验证
ThinkPHP 内置了数据对象的自动验证功能来完成模型的业务规则验证。自动验证是基于数据对象的,而大多情况下数据对象是基于 $_POST表单 (不是绝对的)创建的。
基本的自动验证功能包括:必须字段、email邮箱格式、唯一性、URL地址、数字、两个字段是否相同、是否等于某个值等。
要使用系统的自动验证功能,只需要在对应的 Model类 里面定义 $_validate 属性(由多个验证因子组成的数组),语法如下:
protected $_validate = array( array(验证字段,验证规则,错误提示[,验证条件][,附加规则][,验证时间]) };
验证因子 | 说明 |
---|---|
验证字段 | 必须。需要验证的表单字段名称,这个字段不一定是数据库字段,也可以是表单的一些辅助字段,例如验证码等。 |
验证规则 | 必须。要进行验证的规则,需要联合附加规则一起使用。 |
错误提示 | 必须。当验证不通过时的提示信息。 |
验证条件 |
可选。包括:
|
附加规则 |
可选。配合验证规则使用,包括:
|
验证时间 |
可选。包括:
|
自动验证例子
下面的例子验证文章标题必须填写且检测标题是否已存在:
class ArticleModel extends Model{ protected $_validate = array( array('title','require','标题不能为空!'), array('title','','标题已经存在!',0,'unique',1), }; }
在操作中,当使用 create 方法创建数据对象时会自动进行数据验证操作(当 POST 提交表单处理时):
$Article = D("Article"); if (!$Article->create()){ // 如果创建失败,表示验证没有通过(注:可能原因之一)输出错误提示信息 exit($Article->getError()); }else{ // 验证通过,继续下一步流程如将数据写入数据表 }
系统内置了一些常用正则验证的规则,包括:require(必须)、email(邮箱格式)、url(URL地址)、currency(货币)、number(数字)、qq(QQ号码)、english(英文字符),可以直接使用。
出于用户体验考虑,$Article->getError() 返回的错误提示信息,一般以 Ajax 方式返回,详细参见《ThinkPHP Ajax》。
定义自己的验证规则
当内置的这些验证规则无法满足验证要求是,可以定义自己的验证规则,如要求出生年月以 2000-1-1 格式输入时:
array('birthday','/^d{4}-d{1,2}-d{1,2}$/','出生年月格式错误!'),
可见,只需几行简单的代码,就实现了各种不同方式的表单验证,灵活使用 ThinkPHP 自动验证,可以让开发过程事半功倍。更多自动验证列子,参见本节内容之《ThinkPHP 自动验证实例》。