thinkphp5.1 內建驗證規則大全,詳解
格式驗證類
格式驗證類在使用靜態方法呼叫的時候支援兩種方式呼叫(以number驗證為例,可以使用number() 或者 isNumber())。
1 |
require
|
驗證某個欄位必須,例如:
'name'=>'require'
如果驗證規則沒有新增require就表示沒有值的話不進行驗證,由於require屬於PHP保留字,所以在使用方法驗證的時候必須使用isRequire或者must方法呼叫。
1 |
number
|
驗證某個欄位的值是否為純數字(採用ctype_digit驗證,不包含負數和小數點),例如:
1 |
'num' => 'number'
|
1 |
integer
|
驗證某個欄位的值是否為整數(採用filter_var驗證),例如:
1 |
'num' => 'integer'
|
1 |
float
|
驗證某個欄位的值是否為浮點數字(採用filter_var驗證),例如:
1 |
'num' => 'float'
|
1 |
boolean 或者 bool
|
驗證某個欄位的值是否為布林值(採用filter_var驗證),例如:
1 |
'num' => 'boolean'
|
1 |
email
|
驗證某個欄位的值是否為email地址(採用filter_var驗證),例如:
1 |
'email' => 'email'
|
1 |
array
|
驗證某個欄位的值是否為陣列,例如:
1 |
'info' => 'array'
|
1 |
accepted
|
驗證某個欄位是否為為 yes, on, 或是 1。這在確認"服務條款"是否同意時很有用,例如:
1 |
'accept' => 'accepted'
|
1 |
date
|
驗證值是否為有效的日期,例如:
1 |
'date' => 'date'
|
會對日期值進行strtotime後進行判斷。
1 |
alpha
|
驗證某個欄位的值是否為純字母,例如:
1 |
'name' => 'alpha'
|
1 |
alphaNum
|
驗證某個欄位的值是否為字母和數字,例如:
1 |
'name' => 'alphaNum'
|
1 |
alphaDash
|
驗證某個欄位的值是否為字母和數字,下劃線_及破折號-,例如:
1 |
'name' => 'alphaDash'
|
1 |
chs
|
驗證某個欄位的值只能是漢字,例如:
1 |
'name' => 'chs'
|
1 |
chsAlpha
|
驗證某個欄位的值只能是漢字、字母,例如:
1 |
'name' => 'chsAlpha'
|
1 |
chsAlphaNum
|
驗證某個欄位的值只能是漢字、字母和數字,例如:
1 |
'name' => 'chsAlphaNum'
|
1 |
chsDash
|
驗證某個欄位的值只能是漢字、字母、數字和下劃線_及破折號-,例如:
1 |
'name' => 'chsDash'
|
1 |
cntrl(V5.1.17+)
|
驗證某個欄位的值只能是控制字元(換行、縮排、空格),例如:
1 |
'name' => 'cntrl'
|
1 |
graph (V5.1.17+)
|
驗證某個欄位的值只能是可列印字元(空格除外),例如:
1 |
'name' => 'graph'
|
1 |
print (V5.1.17+)
|
驗證某個欄位的值只能是可列印字元(包括空格),例如:
1 |
'name' => 'print'
|
lower (V5.1.17+)
驗證某個欄位的值只能是小寫字元,例如:
1 |
'name' => 'lower'
|
1 |
upper (V5.1.17+)
|
驗證某個欄位的值只能是大寫字元,例如:
1 |
'name' => 'upper'
|
1 |
space (V5.1.17+)
|
驗證某個欄位的值只能是空白字元(包括縮排,垂直製表符,換行符,回車和換頁字元),例如:
1 |
'name' => 'space'
|
1 |
xdigit (V5.1.17+)
|
驗證某個欄位的值只能是十六進位制字串,例如:
1 |
xdigit (V5.1.17+)
|
1 |
activeUrl
|
驗證某個欄位的值是否為有效的域名或者IP,例如:
1 |
'host' => 'activeUrl'
|
1 |
url
|
驗證某個欄位的值是否為有效的URL地址(採用filter_var驗證),例如:
1 |
'url' => 'url'
|
1 |
驗證某個欄位的值是否為有效的IP地址(採用filter_var驗證),例如:
1 |
'ip' => 'ip'
|
支援驗證ipv4和ipv6格式的IP地址。
1 |
dateFormat:format
|
驗證某個欄位的值是否為指定格式的日期,例如:
1 |
'create_time' => 'dateFormat:y-m-d'
|
1 |
mobile
|
驗證某個欄位的值是否為有效的手機,例如:
1 |
'mobile' => 'mobile'
|
1 |
idCard
|
驗證某個欄位的值是否為有效的身份證格式,例如:
1 |
'id_card' => 'idCard'
|
1 |
macAddr
|
驗證某個欄位的值是否為有效的MAC地址,例如:
1 |
'mac' => 'macAddr'
|
1 |
zip
|
驗證某個欄位的值是否為有效的郵政編碼,例如:
1 |
'zip' => 'zip'
|
長度和區間驗證類
1 |
驗證某個欄位的值是否在某個範圍,例如:
'num'=>'in:1,2,3'
notIn
驗證某個欄位的值不在某個範圍,例如:
1 |
'num' => 'notIn:1,2,3'
|
1 |
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物件,則判斷檔案的大小。
1 |
after:日期
|
驗證某個欄位的值是否在某個日期之後,例如:
1 |
'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欄位是必須的,並且會進行後續的其它驗證。
轉:https://www.cnblogs.com/xfstu/articles/12617713.html