格式驗證類

格式驗證類在使用靜態方法呼叫的時候支援兩種方式呼叫（以number驗證為例，可以使用number() 或者 isNumber()）。

require

驗證某個欄位必須，例如：

'name'=>'require'

如果驗證規則沒有新增require就表示沒有值的話不進行驗證

由於require屬於PHP保留字，所以在使用方法驗證的時候必須使用isRequire或者must方法呼叫。

number

驗證某個欄位的值是否為純數字（採用ctype_digit驗證，不包含負數和小數點），例如：

'num'=>'number'

integer

驗證某個欄位的值是否為整數（採用filter_var驗證），例如：

'num'=>'integer'

float

驗證某個欄位的值是否為浮點數字（採用filter_var驗證），例如：

'num'=>'float'

boolean 或者 bool

驗證某個欄位的值是否為布林值（採用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'

cntrl（V5.1.17+）

驗證某個欄位的值只能是控制字元（換行、縮排、空格），例如：

'name'=>'cntrl'

graph （V5.1.17+）

驗證某個欄位的值只能是可列印字元（空格除外），例如：

'name'=>'graph'

print （V5.1.17+）

驗證某個欄位的值只能是可列印字元（包括空格），例如：

'name'=>'print'

lower （V5.1.17+）

驗證某個欄位的值只能是小寫字元，例如：

'name'=>'lower'

upper （V5.1.17+）

驗證某個欄位的值只能是大寫字元，例如：

'name'=>'upper'

space （V5.1.17+）

驗證某個欄位的值只能是空白字元（包括縮排，垂直製表符，換行符，回車和換頁字元），例如：

'name'=>'space'

xdigit （V5.1.17+）

驗證某個欄位的值只能是十六進位制字串，例如：

'name'=>'xdigit'

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'

mobile

驗證某個欄位的值是否為有效的手機，例如：

'mobile'=>'mobile'

idCard

驗證某個欄位的值是否為有效的身份證格式，例如：

'id_card'=>'idCard'

macAddr

驗證某個欄位的值是否為有效的MAC地址，例如：

'mac'=>'macAddr'

zip

驗證某個欄位的值是否為有效的郵政編碼，例如：

'zip'=>'zip'

長度和區間驗證類

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',

該規則可以用於某個後臺的訪問許可權，多個IP用逗號分隔

denyIp:allow1,allow2,...

驗證當前請求的IP是否禁止訪問，例如：

'name'   => 'denyIp:114.45.4.55',

多個IP用逗號分隔

欄位比較類

confirm

驗證某個欄位是否和另外一個欄位的值一致，例如：

'repassword'=>'require|confirm:password'

支援欄位自動匹配驗證規則，如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'

欄位比較

驗證對比其他欄位大小（數值大小對比），例如：

'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',

上傳驗證

file

驗證是否是一個上傳檔案

image:width,height,type

驗證是否是一個影象檔案，width height和type都是可選，width和height必須同時定義。

fileExt:允許的檔案字尾

驗證上傳檔案字尾

fileMime:允許的檔案型別

驗證上傳檔案型別

fileSize:允許的檔案位元組大小

驗證上傳檔案大小

行為驗證

使用行為驗證資料，例如：

'data'=>'behavior:\app\index\behavior\Check'

其它驗證

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'],

requireIf:field,value

驗證某個欄位的值等於某個值的時候必須，例如：

// 當account的值等於1的時候 password必須
'password'=>'requireIf:account,1'

requireWith:field

驗證某個欄位有值的時候必須，例如：

// 當account有值的時候password欄位必須
'password'=>'requireWith:account'

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欄位是必須的，並且會進行後續的其它驗證。