內置規則 · thinkphp5

系統內置的驗證規則如下： ## 格式驗證類 > ### require 驗證某個字段必須，例如： ~~~ 'name'=>'require' ~~~ > ### number 或者 integer 驗證某個字段的值是否為數字（采用`filter_var`驗證），例如： ~~~ 'num'=>'number' ~~~ > ### float 驗證某個字段的值是否為浮點數字（采用`filter_var`驗證），例如： ~~~ 'num'=>'float' ~~~ > ### boolean 驗證某個字段的值是否為布爾值（采用`filter_var`驗證），例如： ~~~ 'num'=>'boolean' ~~~ > ### email 驗證某個字段的值是否為email地址（采用`filter_var`驗證），例如： ~~~ 'email'=>'email' ~~~ > ### array 驗證某個字段的值是否為數組，例如： ~~~ 'info'=>'array' ~~~ > ### accepted 驗證某個字段是否為為 yes, on, 或是 1。這在確認"服務條款"是否同意時很有用，例如： ~~~ 'accept'=>'accepted' ~~~ > ### date 驗證值是否為有效的日期，例如： ~~~ 'date'=>'date' ~~~ 會對日期值進行`strtotime`后進行判斷。 > ### alpha 驗證某個字段的值是否為字母，例如： ~~~ 'name'=>'alpha' ~~~ > ### alphaNum 驗證某個字段的值是否為字母和數字，例如： ~~~ 'name'=>'alphaNum' ~~~ > ### alphaDash 驗證某個字段的值是否為字母和數字，下劃線`_`及破折號`-`，例如： ~~~ 'name'=>'alphaDash' ~~~ > ### chs 驗證某個字段的值只能是漢字，例如： ~~~ 'name'=>'chs' ~~~ > ### chsAlpha 驗證某個字段的值只能是漢字、字母，例如： ~~~ 'name'=>'chsAlpha' ~~~ > ### chsAlphaNum 驗證某個字段的值只能是漢字、字母和數字，例如： ~~~ 'name'=>'chsAlphaNum' ~~~ > ### chsDash 驗證某個字段的值只能是漢字、字母、數字和下劃線\_及破折號-，例如： ~~~ 'name'=>'chsDash' ~~~ > ### activeUrl 驗證某個字段的值是否為有效的域名或者IP，例如： ~~~ 'host'=>'activeUrl' ~~~ > ### url 驗證某個字段的值是否為有效的URL地址（采用`filter_var`驗證），例如： ~~~ 'url'=>'url' ~~~ > ### ip 驗證某個字段的值是否為有效的IP地址（采用`filter_var`驗證），例如： ~~~ 'ip'=>'ip' ~~~ 支持驗證ipv4和ipv6格式的IP地址。 > ### dateFormat:format 驗證某個字段的值是否為指定格式的日期，例如： ~~~ 'create_time'=>'dateFormat:y-m-d' ~~~ ## 長度和區間驗證類 > ### in 驗證某個字段的值是否在某個范圍，例如： ~~~ 'num'=>'in:1,2,3' ~~~ > ### notIn 驗證某個字段的值不在某個范圍，例如： ~~~ 'num'=>'notIn:1,2,3' ~~~ > ### between 驗證某個字段的值是否在某個區間，例如： ~~~ 'num'=>'between:1,10' ~~~ > ### notBetween 驗證某個字段的值不在某個范圍，例如： ~~~ 'num'=>'notBetween:1,10' ~~~ > ### length:num1,num2 驗證某個字段的值的長度是否在某個范圍，例如： ~~~ 'name'=>'length:4,25' ~~~ 或者指定長度 ~~~ 'name'=>'length:4' ~~~ > 如果驗證的數據是數組，則判斷數組的長度。 > 如果驗證的數據是File對象，則判斷文件的大小。 > ### max:number 驗證某個字段的值的最大長度，例如： ~~~ 'name'=>'max:25' ~~~ > 如果驗證的數據是數組，則判斷數組的長度。 > 如果驗證的數據是File對象，則判斷文件的大小。 > ### min:number 驗證某個字段的值的最小長度，例如： ~~~ 'name'=>'min:5' ~~~ > 如果驗證的數據是數組，則判斷數組的長度。 > 如果驗證的數據是File對象，則判斷文件的大小。 > ### after:日期驗證某個字段的值是否在某個日期之后，例如： ~~~ 'begin_time' => 'after:2016-3-18', ~~~ > ### before:日期驗證某個字段的值是否在某個日期之前，例如： ~~~ 'end_time' => 'before:2016-10-01', ~~~ > ### expire:開始時間,結束時間驗證當前操作（注意不是某個值）是否在某個有效日期之內，例如： ~~~ 'expire_time' => 'expire:2016-2-1,2016-10-01', ~~~ > ### allowIp:allow1,allow2,... 驗證當前請求的IP是否在某個范圍，例如： ~~~ 'name' => 'allowIp:114.45.4.55', ~~~ 該規則可以用于某個后臺的訪問權限 > ### denyIp:allow1,allow2,... 驗證當前請求的IP是否禁止訪問，例如： ~~~ 'name' => 'denyIp:114.45.4.55', ~~~ ## 字段比較類 > ### confirm 驗證某個字段是否和另外一個字段的值一致，例如： ~~~ 'repassword'=>'require|confirm:password' ~~~ `5.0.4+`版本開始，增加了字段自動匹配驗證規則，如password和password\_confirm是自動相互驗證的，只需要使用 ~~~ 'password'=>'require|confirm' ~~~ 會自動驗證和password\_confirm進行字段比較是否一致，反之亦然。 > ### different 驗證某個字段是否和另外一個字段的值不一致，例如： ~~~ 'name'=>'require|different:account' ~~~ > ### eq 或者 = 或者 same 驗證是否等于某個值，例如： ~~~ 'score'=>'eq:100' 'num'=>'=:100' 'num'=>'same:100' ~~~ > ### egt 或者 >= 驗證是否大于等于某個值，例如： ~~~ 'score'=>'egt:60' 'num'=>'>=:100' ~~~ > ### gt 或者 > 驗證是否大于某個值，例如： ~~~ 'score'=>'gt:60' 'num'=>'>:100' ~~~ > ### elt 或者 <= 驗證是否小于等于某個值，例如： ~~~ 'score'=>'elt:100' 'num'=>'<=:100' ~~~ > ### lt 或者 < 驗證是否小于某個值，例如： ~~~ 'score'=>'lt:100' 'num'=>'<:100' ~~~ > ### 驗證字段比較支持對比其他字段（V5.0.8+）驗證對比其他字段大小（數值大小對比），例如： ~~~ '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`屬性 ~~~ protected $regex = [ 'zip' => '\d{6}']; ~~~ 然后就可以使用 ~~~ 'zip' => 'regex:zip', ~~~ ## 上傳驗證 > ### file 驗證是否是一個上傳文件 > ### image:width,height,type 驗證是否是一個圖像文件，width height和type都是可選，width和height必須同時定義。 > ### fileExt:允許的文件后綴驗證上傳文件后綴 > ### fileMime:允許的文件類型驗證上傳文件類型 > ### fileSize:允許的文件字節大小驗證上傳文件大小 ## 行為驗證使用行為驗證數據，例如： ~~~ 'data'=>'behavior:\app\index\behavior\Check' ~~~ ## 其它驗證 > ### unique:table,field,except,pk | 版本 | 調整功能 | | --- | --- | | 5.0.5 | 支持指定完整模型類并且默認會優先檢測模型類是否存在不存在則檢測數據表 | 驗證當前請求的字段值是否為唯一的，例如： ~~~ // 表示驗證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'], ~~~ > ### requireIf:field,value 驗證某個字段的值等于某個值的時候必須，例如： ~~~ // 當account的值等于1的時候 password必須 'password'=>'requireIf:account,1' ~~~ > ### requireWith:field 驗證某個字段有值的時候必須，例如： ~~~ // 當account有值的時候password字段必須 'password'=>'requireWith:account' ~~~