1. 程式人生 > >ThinkPHP 自動完成 和 自動驗證

ThinkPHP 自動完成 和 自動驗證

自動完成:

兩種方式的定義規則都採用:

  1. array(
  2. array(完成欄位1,完成規則,[完成條件,附加規則]),
  3. array(完成欄位2,完成規則,[完成條件,附加規則]),
  4. ......
  5. );

  1. namespaceHome\Model;
  2. useThink\Model;
  3. classUserModelextendsModel{
  4. protected $_auto = array (
  5. array('status','1'),// 新增的時候把status欄位設定為1
  6. array('password','md5',3,'function'),// 對password欄位在新增和編輯的時候使md5函式處理
  7. array('name','getName',3,'callback'),// 對name欄位在新增和編輯的時候回撥getName方法
  8. array('update_time','time',2,'function'),// 對update_time欄位在更新的時候寫入當前時間戳
  9. );
  10. }
完成時間(可選)

設定自動完成的時間,包括:

設定 說明
self::MODEL_INSERT或者1 新增資料的時候處理(預設)
self::MODEL_UPDATE或者2 更新資料的時候處理
self::MODEL_BOTH或者3 所有情況都進行處理
附加規則(可選)

包括:

規則 說明
function 使用函式,表示填充的內容是一個函式名
callback 回撥方法 ,表示填充的內容是一個當前模型的方法
field 用其它欄位填充,表示填充的內容是一個其他欄位的值
string 字串(預設方式)
ignore 為空則忽略(3.1.2新增)

自動驗證:

無論是什麼方式,驗證規則的定義是統一的規則,定義格式為:

  1. array(
  2. array(驗證欄位1,驗證規則,錯誤提示,[驗證條件,附加規則,驗證時間]),
  3. array(驗證欄位2,驗證規則,錯誤提示,[驗證條件,附加規則,驗證時間]),
  4. ......
  5. );
驗證欄位 (必須)

需要驗證的表單欄位名稱,這個欄位不一定是資料庫欄位,也可以是表單的一些輔助欄位,例如確認密碼和驗證碼等等。有個別驗證規則和欄位無關的情況下,驗證欄位是可以隨意設定的,例如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方法建立資料物件的時候自動呼叫:

  1. $User = D("User");// 例項化User物件
  2. if(!$User->create()){
  3. // 如果建立失敗 表示驗證沒有通過 輸出錯誤提示資訊
  4. exit($User->getError());
  5. }else{
  6. // 驗證通過 可以進行其他資料操作
  7. }

系統支援資料的批量驗證功能,只需要在模型類裡面設定patchValidate屬性為true( 預設為false),

  1. protected $patchValidate =true;

設定批處理驗證後,getError() 方法返回的錯誤資訊是一個數組