自動驗證是ThinkPHP模型層提供的一種數據驗證方法,可以在使用create創建數據對象的時候自動進行數據驗證。
數據驗證有兩種方式:
- 靜態方式:在模型類里面通過$_validate屬性定義驗證規則。
- 動態方式:使用模型類的validate方法動態創建自動驗證規則。
無論是什么方式,驗證規則的定義是統一的規則,定義格式為:
array( array(驗證字段1,驗證規則,錯誤提示,[驗證條件,附加規則,驗證時間]), array(驗證字段2,驗證規則,錯誤提示,[驗證條件,附加規則,驗證時間]), ......);
驗證字段 (必須)
需要驗證的表單字段名稱,這個字段不一定是數據庫字段,也可以是表單的一些輔助字段,例如確認密碼和驗證碼等等。
驗證規則 (必須)
要進行驗證的規則,需要結合附加規則,如果在使用正則驗證的附加規則情況下,系統還內置了一些常用正則驗證的規則,可以直接作為驗證規則使用,包括:require 字段必須、email 郵箱、url URL地址、currency 貨幣、number 數字。
提示信息 (必須)
用於驗證失敗后的提示信息定義
驗證條件 (可選)
包含下面幾種情況:
- self::EXISTS_VALIDATE 或者0 存在字段就驗證(默認)
- self::MUST_VALIDATE 或者1 必須驗證
- self::VALUE_VALIDATE或者2 值不為空的時候驗證
附加規則 (可選)
配合驗證規則使用,包括下面一些規則:
驗證時間(可選)
- self::MODEL_INSERT或者1新增數據時候驗證
- self::MODEL_UPDATE或者2編輯數據時候驗證
- self::MODEL_BOTH或者3全部情況下驗證(默認)
這里的驗證時間需要注意,並非只有這三種情況,你可以根據業務需要增加其他的驗證時間。
靜態定義
在模型類里面預先定義好該模型的自動驗證規則,我們稱為靜態定義。
舉例說明,我們在模型類里面定義了$_validate
屬性如下:
namespace Home\Model; use Think\Model; class UserModel extends Model{ protected $_validate = array( array('verify','require','驗證碼必須!'), //默認情況下用正則進行驗證 array('name','','帳號名稱已經存在!',0,'unique',1), // 在新增的時候驗證name字段是否唯一 array('value',array(1,2,3),'值的范圍不正確!',2,'in'), // 當值不為空的時候判斷是否在一個范圍內 array('repassword','password','確認密碼不正確',0,'confirm'), // 驗證確認密碼是否和密碼一致 array('password','checkPwd','密碼格式不正確',0,'function'), // 自定義函數驗證密碼格式 );}
定義好驗證規則后,就可以在使用create方法創建數據對象的時候自動調用:
$User = D("User"); // 實例化User對象 if (!$User->create()){ // 如果創建失敗 表示驗證沒有通過 輸出錯誤提示信息 exit($User->getError());} else{ // 驗證通過 可以進行其他數據操作}
在進行自動驗證的時候,系統會對定義好的驗證規則進行依次驗證。如果某一條驗證規則沒有通過,則會報錯,getError方法返回的錯誤信息(字符串)就是對應字段的驗證規則里面的錯誤提示信息。
靜態定義方式因為必須定義模型類,所以只能用D函數實例化模型
批量驗證
系統支持數據的批量驗證功能,只需要在模型類里面設置patchValidate屬性為true( 默認為false),
設置批處理驗證后,getError()
方法返回的錯誤信息是一個數組,返回格式是:
array("字段名1"=>"錯誤提示1","字段名2"=>"錯誤提示2"... )
動態驗證
如果采用動態驗證的方式,就比較靈活,可以根據不同的需要,在操作同一個模型的時候使用不同的驗證規則,例如上面的靜態驗證方式可以改為:
$rules = array( array('verify','require','驗證碼必須!'), //默認情況下用正則進行驗證 array('name','','帳號名稱已經存在!',0,'unique',1), // 在新增的時候驗證name字段是否唯一 array('value',array(1,2,3),'值的范圍不正確!',2,'in'), // 當值不為空的時候判斷是否在一個范圍內 array('repassword','password','確認密碼不正確',0,'confirm'), // 驗證確認密碼是否和密碼一致 array('password','checkPwd','密碼格式不正確',0,'function'), // 自定義函數驗證密碼格式); $User = M("User"); // 實例化User對象 if (!$User->validate($rules)->create()){ // 如果創建失敗 表示驗證沒有通過 輸出錯誤提示信息 exit($User->getError());} else{ // 驗證通過 可以進行其他數據操作}