內置規則 · ThinkPHP5.1完全開發手冊

系統內置了一些常用的驗證規則，可以完成大部分場景的驗證需求，包括： [TOC=2,2] >[danger] 驗證規則嚴格區分大小寫 ## 格式驗證類格式驗證類在使用靜態方法調用的時候支持兩種方式調用（以`number`驗證為例，可以使用`number()` 或者 `isNumber()`）。 >[info]### require 驗證某個字段必須，例如： ~~~ 'name'=>'require' ~~~ >[danger] 如果驗證規則沒有添加`require`就表示沒有值的話不進行驗證 >[danger] 由于`require`屬于PHP保留字，所以在使用方法驗證的時候必須使用`isRequire`或者`must`方法調用。 >[info]### number 驗證某個字段的值是否為純數字（采用`ctype_digit`驗證，不包含負數和小數點），例如： ~~~ 'num'=>'number' ~~~ >[info]### integer 驗證某個字段的值是否為整數（采用`filter_var`驗證），例如： ~~~ 'num'=>'integer' ~~~ >[info]### float 驗證某個字段的值是否為浮點數字（采用`filter_var`驗證），例如： ~~~ 'num'=>'float' ~~~ >[info]### boolean 或者 bool 驗證某個字段的值是否為布爾值（采用`filter_var`驗證），例如： ~~~ 'num'=>'boolean' ~~~ >[info]### email 驗證某個字段的值是否為email地址（采用`filter_var`驗證），例如： ~~~ 'email'=>'email' ~~~ >[info]### array 驗證某個字段的值是否為數組，例如： ~~~ 'info'=>'array' ~~~ >[info]### accepted 驗證某個字段是否為為 yes, on, 或是 1。這在確認"服務條款"是否同意時很有用，例如： ~~~ 'accept'=>'accepted' ~~~ >[info]### date 驗證值是否為有效的日期，例如： ~~~ 'date'=>'date' ~~~ 會對日期值進行`strtotime`后進行判斷。 >[info]### alpha 驗證某個字段的值是否為純字母，例如： ~~~ 'name'=>'alpha' ~~~ >[info]### alphaNum 驗證某個字段的值是否為字母和數字，例如： ~~~ 'name'=>'alphaNum' ~~~ >[info]### alphaDash 驗證某個字段的值是否為字母和數字，下劃線`_`及破折號`-`，例如： ~~~ 'name'=>'alphaDash' ~~~ >[info]### chs 驗證某個字段的值只能是漢字，例如： ~~~ 'name'=>'chs' ~~~ >[info]### chsAlpha 驗證某個字段的值只能是漢字、字母，例如： ~~~ 'name'=>'chsAlpha' ~~~ >[info]### chsAlphaNum 驗證某個字段的值只能是漢字、字母和數字，例如： ~~~ 'name'=>'chsAlphaNum' ~~~ >[info]### chsDash 驗證某個字段的值只能是漢字、字母、數字和下劃線_及破折號-，例如： ~~~ 'name'=>'chsDash' ~~~ >[info]### cntrl（`V5.1.17+`）驗證某個字段的值只能是控制字符（換行、縮進、空格），例如： ~~~ 'name'=>'cntrl' ~~~ >[info]### graph （`V5.1.17+`）驗證某個字段的值只能是可打印字符（空格除外），例如： ~~~ 'name'=>'graph' ~~~ >[info]### print （`V5.1.17+`）驗證某個字段的值只能是可打印字符（包括空格），例如： ~~~ 'name'=>'print' ~~~ >[info]### lower （`V5.1.17+`）驗證某個字段的值只能是小寫字符，例如： ~~~ 'name'=>'lower' ~~~ >[info]### upper （`V5.1.17+`）驗證某個字段的值只能是大寫字符，例如： ~~~ 'name'=>'upper' ~~~ >[info]### space （`V5.1.17+`）驗證某個字段的值只能是空白字符（包括縮進，垂直制表符，換行符，回車和換頁字符），例如： ~~~ 'name'=>'space' ~~~ >[info]### xdigit （`V5.1.17+`）驗證某個字段的值只能是十六進制字符串，例如： ~~~ 'name'=>'xdigit' ~~~ >[info]### activeUrl 驗證某個字段的值是否為有效的域名或者IP，例如： ~~~ 'host'=>'activeUrl' ~~~ >[info]### url 驗證某個字段的值是否為有效的URL地址（采用`filter_var`驗證），例如： ~~~ 'url'=>'url' ~~~ >[info]### ip 驗證某個字段的值是否為有效的IP地址（采用`filter_var`驗證），例如： ~~~ 'ip'=>'ip' ~~~ 支持驗證ipv4和ipv6格式的IP地址。 >[info]### dateFormat:format 驗證某個字段的值是否為指定格式的日期，例如： ~~~ 'create_time'=>'dateFormat:y-m-d' ~~~ >[info]### mobile 驗證某個字段的值是否為有效的手機，例如： ~~~ 'mobile'=>'mobile' ~~~ >[info]### idCard 驗證某個字段的值是否為有效的身份證格式，例如： ~~~ 'id_card'=>'idCard' ~~~ >[info]### macAddr 驗證某個字段的值是否為有效的MAC地址，例如： ~~~ 'mac'=>'macAddr' ~~~ >[info]### zip 驗證某個字段的值是否為有效的郵政編碼，例如： ~~~ 'zip'=>'zip' ~~~ ## 長度和區間驗證類 >[info]### in 驗證某個字段的值是否在某個范圍，例如： ~~~ 'num'=>'in:1,2,3' ~~~ >[info]### notIn 驗證某個字段的值不在某個范圍，例如： ~~~ 'num'=>'notIn:1,2,3' ~~~ >[info]### between 驗證某個字段的值是否在某個區間，例如： ~~~ 'num'=>'between:1,10' ~~~ >[info]### notBetween 驗證某個字段的值不在某個范圍，例如： ~~~ 'num'=>'notBetween:1,10' ~~~ >[info]### length:num1,num2 驗證某個字段的值的長度是否在某個范圍，例如： ~~~ 'name'=>'length:4,25' ~~~ 或者指定長度 ~~~ 'name'=>'length:4' ~~~ > 如果驗證的數據是數組，則判斷數組的長度。 > 如果驗證的數據是File對象，則判斷文件的大小。 >[info]### max:number 驗證某個字段的值的最大長度，例如： ~~~ 'name'=>'max:25' ~~~ > 如果驗證的數據是數組，則判斷數組的長度。 > 如果驗證的數據是File對象，則判斷文件的大小。 >[info]### min:number 驗證某個字段的值的最小長度，例如： ~~~ 'name'=>'min:5' ~~~ > 如果驗證的數據是數組，則判斷數組的長度。 > 如果驗證的數據是File對象，則判斷文件的大小。 >[info]### after:日期驗證某個字段的值是否在某個日期之后，例如： ~~~ 'begin_time' => 'after:2016-3-18', ~~~ >[info]### before:日期驗證某個字段的值是否在某個日期之前，例如： ~~~ 'end_time' => 'before:2016-10-01', ~~~ >[info]### expire:開始時間,結束時間驗證當前操作（注意不是某個值）是否在某個有效日期之內，例如： ~~~ 'expire_time' => 'expire:2016-2-1,2016-10-01', ~~~ >[info]### allowIp:allow1,allow2,... 驗證當前請求的IP是否在某個范圍，例如： ~~~ 'name' => 'allowIp:114.45.4.55', ~~~ 該規則可以用于某個后臺的訪問權限，多個IP用逗號分隔 >[info]### denyIp:allow1,allow2,... 驗證當前請求的IP是否禁止訪問，例如： ~~~ 'name' => 'denyIp:114.45.4.55', ~~~ 多個IP用逗號分隔 ## 字段比較類 >[info]### confirm 驗證某個字段是否和另外一個字段的值一致，例如： ~~~ 'repassword'=>'require|confirm:password' ~~~ 支持字段自動匹配驗證規則，如`password`和`password_confirm`是自動相互驗證的，只需要使用 ~~~ 'password'=>'require|confirm' ~~~ 會自動驗證和`password_confirm`進行字段比較是否一致，反之亦然。 >[info]### different 驗證某個字段是否和另外一個字段的值不一致，例如： ~~~ 'name'=>'require|different:account' ~~~ >[info]### eq 或者 = 或者 same 驗證是否等于某個值，例如： ~~~ 'score'=>'eq:100' 'num'=>'=:100' 'num'=>'same:100' ~~~ >[info]### egt 或者 >= 驗證是否大于等于某個值，例如： ~~~ 'score'=>'egt:60' 'num'=>'>=:100' ~~~ >[info]### gt 或者 > 驗證是否大于某個值，例如： ~~~ 'score'=>'gt:60' 'num'=>'>:100' ~~~ >[info]### elt 或者 <= 驗證是否小于等于某個值，例如： ~~~ 'score'=>'elt:100' 'num'=>'<=:100' ~~~ >[info]### lt 或者 < 驗證是否小于某個值，例如： ~~~ 'score'=>'lt:100' 'num'=>'<:100' ~~~ >[info]### 字段比較驗證對比其他字段大小（數值大小對比），例如： ~~~ 'price'=>'lt:market_price' 'price'=>'<:market_price' ~~~ ## filter驗證支持使用`filter_var`進行驗證，例如： ~~~ 'ip'=>'filter:validate_ip' ~~~ ## 正則驗證支持直接使用正則驗證，例如： ~~~ 'zip'=>'\d{6}', // 或者 'zip'=>'regex:\d{6}', ~~~ 如果你的正則表達式中包含有`|`符號的話，必須使用數組方式定義。 ~~~ 'accepted'=>['regex'=>'/^(yes|on|1)$/i'], ~~~ 也可以實現預定義正則表達式后直接調用，例如在驗證器類中定義regex屬性 ~~~ namespace app\index\validate; use think\Validate; class User extends Validate { protected $regex = [ 'zip' => '\d{6}']; protected $rule = [ 'name' => 'require|max:25', 'email' => 'email', ]; } ~~~ 然后就可以使用 ~~~ 'zip' => 'regex:zip', ~~~ ## 上傳驗證 >[info]### file 驗證是否是一個上傳文件 >[info]### image:width,height,type 驗證是否是一個圖像文件，width height和type都是可選，width和height必須同時定義。 >[info]### fileExt:允許的文件后綴驗證上傳文件后綴 >[info]### fileMime:允許的文件類型驗證上傳文件類型 >[info]### fileSize:允許的文件字節大小驗證上傳文件大小 ## 行為驗證使用行為驗證數據，例如： ~~~ 'data'=>'behavior:\app\index\behavior\Check' ~~~ ## 其它驗證 >[info]### unique:table,field,except,pk 驗證當前請求的字段值是否為唯一的，例如： ~~~ // 表示驗證name字段的值是否在user表（不包含前綴）中唯一 'name' => 'unique:user', // 驗證其他字段 'name' => 'unique:user,account', // 排除某個主鍵值 'name' => 'unique:user,account,10', // 指定某個主鍵值排除 'name' => 'unique:user,account,10,user_id', ~~~ 如果需要對復雜的條件驗證唯一，可以使用下面的方式： ~~~ // 多個字段驗證唯一驗證條件 'name' => 'unique:user,status^account', // 復雜驗證條件 'name' => 'unique:user,status=1&account='.$data['account'], ~~~ >[info]### requireIf:field,value 驗證某個字段的值等于某個值的時候必須，例如： ~~~ // 當account的值等于1的時候 password必須 'password'=>'requireIf:account,1' ~~~ >[info]### requireWith:field 驗證某個字段有值的時候必須，例如： ~~~ // 當account有值的時候password字段必須 'password'=>'requireWith:account' ~~~ >[info]### requireCallback:callable 驗證當某個callable為真的時候字段必須，例如： ~~~ // 使用check_require方法檢查是否需要驗證age字段必須 'age'=>'requireCallback:check_require|number' ~~~ 用于檢查是否需要驗證的方法支持兩個參數，第一個參數是當前字段的值，第二個參數則是所有的數據。 ~~~ function check_require($value, $data){ if(empty($data['birthday'])){ return true; } } ~~~ 只有check_require函數返回true的時候age字段是必須的，并且會進行后續的其它驗證。