系統內置的驗證規則如下:
## 格式驗證類
>[info]### require
驗證某個字段必須,例如:
~~~
'name'=>'require'
~~~
>[info]### number 或者 integer
驗證某個字段的值是否為數字(采用`filter_var`驗證),例如:
~~~
'num'=>'number'
~~~
>[info]### float
驗證某個字段的值是否為浮點數字(采用`filter_var`驗證),例如:
~~~
'num'=>'float'
~~~
>[info]### boolean
驗證某個字段的值是否為布爾值(采用`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]### 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]### 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',
~~~
該規則可以用于某個后臺的訪問權限
>[info]### denyIp:allow1,allow2,...
驗證當前請求的IP是否禁止訪問,例如:
~~~
'name' => 'denyIp:114.45.4.55',
~~~
## 字段比較類
>[info]### confirm
驗證某個字段是否和另外一個字段的值一致,例如:
~~~
'repassword'=>'require|confirm:password'
~~~
`5.0.4+`版本開始,增加了字段自動匹配驗證規則,如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]### 驗證字段比較支持對比其他字段(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',
~~~
## 上傳驗證
>[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
|版本|調整功能|
|---|---|
|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'],
~~~
>[info]### requireIf:field,value
驗證某個字段的值等于某個值的時候必須,例如:
~~~
// 當account的值等于1的時候 password必須
'password'=>'requireIf:account,1'
~~~
>[info]### requireWith:field
驗證某個字段有值的時候必須,例如:
~~~
// 當account有值的時候password字段必須
'password'=>'requireWith:account'
~~~
- 序言
- 基礎
- 安裝ThinkPHP
- 開發規范
- 目錄結構
- 架構
- 架構總覽
- 生命周期
- 入口文件
- URL訪問
- 模塊設計
- 命名空間
- 自動加載
- Traits引入
- API友好
- 配置
- 配置目錄
- 配置格式
- 配置加載
- 讀取配置
- 動態配置
- 獨立配置
- 配置作用域
- 環境變量配置
- 路由
- 路由模式
- 路由定義
- 批量注冊
- 變量規則
- 組合變量
- 路由參數
- 路由地址
- 資源路由
- 快捷路由
- 路由別名
- 路由分組
- MISS路由
- 閉包支持
- 路由綁定
- 綁定模型
- 域名路由
- URL生成
- 控制器
- 控制器定義
- 控制器初始化
- 前置操作
- 跳轉和重定向
- 空操作
- 空控制器
- 多級控制器
- 分層控制器
- Rest控制器
- 自動定位控制器
- 資源控制器
- 請求
- 請求信息
- 輸入變量
- 更改變量
- 請求類型
- 請求偽裝
- HTTP頭信息
- 偽靜態
- 方法注入
- 屬性注入
- 參數綁定
- 依賴注入
- 請求緩存
- 數據庫
- 連接數據庫
- 基本使用
- 查詢構造器
- 查詢數據
- 添加數據
- 更新數據
- 刪除數據
- 查詢方法
- 查詢語法
- 鏈式操作
- where
- table
- alias
- field
- order
- limit
- page
- group
- having
- join
- union
- distinct
- lock
- cache
- comment
- fetchSql
- force
- bind
- partition
- strict
- failException
- sequence
- 聚合查詢
- 時間查詢
- 高級查詢
- 視圖查詢
- 子查詢
- 原生查詢
- 查詢事件
- 事務操作
- 監聽SQL
- 存儲過程
- 數據集
- 分布式數據庫
- 模型
- 定義
- 模型初始化
- 新增
- 更新
- 刪除
- 查詢
- 聚合
- 獲取器
- 修改器
- 時間戳
- 只讀字段
- 軟刪除
- 類型轉換
- 數據完成
- 查詢范圍
- 模型分層
- 數組訪問和轉換
- JSON序列化
- 事件
- 關聯
- 一對一關聯
- 一對多關聯
- 遠程一對多
- 多對多關聯
- 多態關聯
- 動態屬性
- 關聯預載入
- 關聯統計
- 聚合模型
- 視圖
- 視圖實例化
- 模板引擎
- 模板賦值
- 模板渲染
- 輸出替換
- 模板
- 模板定位
- 模板標簽
- 變量輸出
- 系統變量
- 請求參數
- 使用函數
- 使用默認值
- 使用運算符
- 三元運算
- 原樣輸出
- 模板注釋
- 模板布局
- 模板繼承
- 包含文件
- 標簽庫
- 內置標簽
- 循環輸出標簽
- 比較標簽
- 條件判斷
- 資源文件加載
- 標簽嵌套
- 原生PHP
- 定義標簽
- 日志
- 介紹
- 日志驅動
- 日志寫入
- 獨立日志
- 日志清空
- 寫入授權
- 錯誤和調試
- 調試模式
- 異常處理
- 拋出異常
- Trace調試
- 變量調試
- 性能調試
- SQL調試
- 遠程調試
- 404頁面
- 驗證
- 驗證器
- 驗證規則
- 錯誤信息
- 驗證場景
- 控制器驗證
- 模型驗證
- 內置規則
- 靜態調用
- 表單令牌
- 安全
- 輸入安全
- 數據庫安全
- 上傳安全
- 其它安全建議
- 雜項
- 緩存
- Session
- Cookie
- 多語言
- 分頁
- 上傳
- 驗證碼
- 圖像處理
- 文件處理
- 單元測試
- 擴展
- 函數
- 類庫
- 行為
- 驅動
- Composer包
- Time
- 數據庫遷移工具
- Workerman
- MongoDb
- SAE
- 標簽擴展
- 命令行
- 自動生成目錄結構
- 創建類庫文件
- 生成類庫映射文件
- 生成路由緩存
- 清除緩存文件
- 生成配置緩存文件
- 生成數據表字段緩存
- 自定義命令行
- 部署
- 虛擬主機環境
- Linux 主機環境
- URL重寫
- 附錄
- 配置參考
- 常量參考
- 助手函數
- 升級指導
- 更新日志