小編給大家分享一下Yii核心驗證器api的示例分析,相信大部分人都還不怎么了解,因此分享這篇文章給大家參考一下,希望大家閱讀完這篇文章后大有收獲,下面讓我們一起去了解一下吧!
成都創(chuàng)新互聯(lián)自成立以來,一直致力于為企業(yè)提供從網(wǎng)站策劃、網(wǎng)站設(shè)計、成都網(wǎng)站設(shè)計、成都網(wǎng)站建設(shè)、電子商務(wù)、網(wǎng)站推廣、網(wǎng)站優(yōu)化到為企業(yè)提供個性化軟件開發(fā)等基于互聯(lián)網(wǎng)的全面整合營銷服務(wù)。公司擁有豐富的網(wǎng)站建設(shè)和互聯(lián)網(wǎng)應(yīng)用系統(tǒng)開發(fā)管理經(jīng)驗、成熟的應(yīng)用系統(tǒng)解決方案、優(yōu)秀的網(wǎng)站開發(fā)工程師團隊及專業(yè)的網(wǎng)站設(shè)計師團隊。具體如下:
核心驗證器 Core Validators
前言
Yii 提供了一系列常用的核心 validators, 你可在
yii\validators namespace 中找到. 不用使用長的驗證器類名, 你可以使用別名代替他們.
例如, 你可以使用別名 required 代替 yii\validators\RequiredValidator 類:
<?php public function rules() { return [ [['email', 'password'], 'required'], ]; } ?>
這個 yii\validators\Validator::$builtInValidators 屬性生命所有支持的驗證器的別名.
接下來, 我們將講解每種核心驗證器的用法.
1. boolean 對錯值
<?php [ // 檢查是否 "selected" 是 0 或 1, 不管數(shù)據(jù)類型 ['selected', 'boolean'], // 檢查是否 "deleted" 是一個 boolean 類型, 只能是 true 或則 false ['deleted', 'boolean', 'trueValue' => true, 'falseValue' => false, 'strict' => true], ] ?>
上面檢測是否是一個bool值.
trueValue: 代表true時的值. 默認(rèn)為 '1'.
falseValue: 代表 false 時的值. 默認(rèn)為 '0'.
strict: 是否輸入框中的值必須匹配 設(shè)置的 trueValue 和 falseValue. 默認(rèn)為 false.
注意: 因為數(shù)據(jù)提交通過HTML形式都是字符創(chuàng), 一般你需要設(shè)置 strict 屬性為 false.
2. captcha 驗證碼
<?php [ ['verificationCode', 'captcha'], ] ?>
這個驗證器通常和
yii\captcha\CaptchaAction 以及
yii\captcha\Captcha 一起使用以確保輸入的是相同的驗證碼 通過 CAPTCHA 組件.
caseSensitive: 是否驗證碼需要區(qū)分大小寫. 默認(rèn)為 false.
captchaAction: 默認(rèn)的驗證碼的 CAPTCHA action 生成 CAPTCHA image的路徑. 默認(rèn)為 'site/captcha'.
skipOnEmpty: 輸入為空的時候是否跳過驗證. 默認(rèn)false, 即 input 輸入是必須的.
3. compare 比較
<?php [ // 驗證是否 "password" 屬性和 "password_repeat"是否相等 ['password', 'compare'], // 驗證 age >= 30 ['age', 'compare', 'compareValue' => 30, 'operator' => '>='], ] ?>
這個驗證器比較指定的輸入值和另一個值確保他們之間使用指定的操作符.
compareAttribute: 屬性的名字即將會和誰比較.當(dāng)驗證器被用來驗證一個屬性的時候, 他會和屬性名字相同 但帶有后綴 _repeat的屬性相比較. 例如, 如果要驗證的屬性名是 password, 那么默認(rèn)對比的屬性名就是 password_repeat 你可以指定你想要的值.
compareValue: 一個和輸入值比較的常量值. 當(dāng) property 和 compareAttribute 屬性被同時指定的時候, 這個值將優(yōu)先.
operator: 比較的操作符. 默認(rèn)是 ==, 即輸入值和 compareAttribute 或 compareValue 值相等的時候才會成功.
支持下面這些操作符: ==、===、!=、!==、>、>=、<、<=。
4. date 日期
<?php [ [['from_date', 'to_date'], 'date'], ] ?>
這個驗證器檢查輸入的值是一個日期date, 時間time 或者datetime 以一個合適的形式. 可選的,他能轉(zhuǎn)換輸入值成為一個UNIX時間戳存儲在一個通過timestampAttribute 指定的屬性里.
format: 這個 date/time 是 /tupian/20230522/datetime.createfromformat.php 中聲明的所有支持的格式
如果這個值沒有設(shè)置, 他會自動取值 Yii::$app->formatter->dateFormat.
timestampAttribute: 屬性名用來存儲轉(zhuǎn)換將輸入的日期或時間. 也可以是相同的屬性名作為被驗證過的. 如果是這種情況, 原始的值將會被時間戳重寫. 你可以看看 "如何處理日期選擇器 DatePicker" 用例子.
http://www.yiiframework.com/doc-2.0/widget-jui#datepicker-date-input
如果輸入的是可選的,你也可能要添加一個默認(rèn)值濾波器除了日期驗證,以確??蛰斎氪鎯镹ULL。否則你可能最終得到的日期像日期選擇器的輸入字段在0000-00-00 或 您的數(shù)據(jù)庫1970-01-01.
<?php [ [['from_date', 'to_date'], 'default', 'value' => null], [['from_date', 'to_date'], 'date'], ], ?>
5.default 默認(rèn)值
<?php [ // 設(shè)置 "age" 為 null 如果他是空的 ['age', 'default', 'value' => null], // 設(shè)置 "country" 為 "USA" 如果他是空的 ['country', 'default', 'value' => 'USA'], // 分配 "from" 和 "to" 分別加3天和6天, 如果他們是空的話 [['from', 'to'], 'default', 'value' => function ($model, $attribute) { return date('Y-m-d', strtotime($attribute === 'to' ? '+3 days' : '+6 days')); }], ] ?>
這個驗證器不驗證數(shù)據(jù). 當(dāng)他們?yōu)榭盏臅r候.分配給屬性值。
value: 表單的默認(rèn)值 函數(shù)原型如下,
<?php function foo($model, $attribute) { // ... 組裝 $value ... return $value; } ?>
6. double 浮點值
<?php [ // 檢查 "salary" 是一個 double 數(shù)字 ['salary', 'double'], ] ?>
相當(dāng)于一個數(shù)字驗證器:
max: 數(shù)字上限,沒設(shè)置不檢查
min: 數(shù)字下線,沒設(shè)置不檢查
7. email 郵箱驗證
<?php [ // 檢查郵箱是一個有效的 "email"地址 ['email', 'email'], ] ?>
allowName: 檢查名字是否允許在郵箱中出現(xiàn) (e.g. John Smith <john.smith@example.com>). 默認(rèn)為 false.
checkDNS,是否檢查電子郵件的域名是否存在,是否有任何一個A或MX記錄。請注意,這可能檢查由于臨時DNS問題失敗,即使電子郵件地址實際上是有效的。默認(rèn)為false。
enableIDN,驗證過程是否應(yīng)考慮到IDN(國際化域名)。默認(rèn)為false。需要注意的是,為了使用IDN驗證您必須安裝并啟用國際PHP擴展,或異常將被拋出。
8. exist 是否存在
<?php [ // a1 需要在 屬性列中存在 "a1" 這個好像默認(rèn)就有啊 ['a1', 'exist'], // a1 存在,但它的值將使用A2來檢查是否存在 ['a1', 'exist', 'targetAttribute' => 'a2'], // a1 和 a2 需要同時存在, 他們都將接收錯誤信息 [['a1', 'a2'], 'exist', 'targetAttribute' => ['a1', 'a2']], // a1 和 a2 需要同時存在, 只有 a1 將接收錯誤信息 ['a1', 'exist', 'targetAttribute' => ['a1', 'a2']], // a1 需要存在 通過檢測a2 和 a3 (用 a1 的值) ['a1', 'exist', 'targetAttribute' => ['a2', 'a1' => 'a3']], // a1 需要存在. 如果 a1是一個數(shù)組, 那么每個元素都必須存在. ['a1', 'exist', 'allowArray' => true], ] ?>
這個驗證器檢查輸入的值能否被找到在在對應(yīng)的表的列值里,他只會在 Active Record model 模型的屬性里起作用.
他支持驗證單列或多列
targetClass: 用來尋找輸入值驗證的 Active Record 類名. 如果未設(shè)置, 默認(rèn)使用當(dāng)前設(shè)置的模型類.
targetAttribute: 應(yīng)該用于驗證輸入值的存在在targetClass的屬性的名稱。如果沒有設(shè)置,將使用目前正在驗證的屬性的名稱??梢允褂藐嚵衼眚炞C多列的存在的同時。數(shù)組的值是將被用于驗證存在的屬性,而數(shù)組鍵是其值要驗證的屬性。如果鍵和值都是一樣的,你可以指定值.
filter: additional filter to be applied to the DB query used to check the existence of the input value. This can be a string or an array representing the additional query condition (refer to yii\db\Query::where() on the format of query condition), or an anonymous function with the signature function ($query), where $query is the Query object that you can modify in the function.
allowArray: 是否允許輸入的值是一個array.默認(rèn) false. 若果屬性是 true 而且輸入是一個 array, 那么熟這里的每一個元素都必須存在在指向的目標(biāo)列里. 注意這個屬性不能被設(shè)置成true 如果你設(shè)置驗證多列通過設(shè)置 targetAttribute 為一個 array.
9. file 文件驗證
<?php [ // 檢查 "primaryImage" 上傳的文件格式是 PNG, JPG 或者 GIF // the file size must be less than 1MB ['primaryImage', 'file', 'extensions' => ['png', 'jpg', 'gif'], 'maxSize' => 1024*1024], ] ?>
檢查是否是一個有效的上傳文件。
extensions: 允許上傳的文件類型列表.他可以是一個數(shù)組 或者是一個以逗號分割的字符串(如. "gif, jpg"). 擴展名不區(qū)分大小寫,默認(rèn)為 null, 意味著所有的文件擴展名是允許的.
mimeTypes: 允許上傳的文件資源的媒體類型。他可以是一個數(shù)組 或者是一個以逗號或空格分割的字符串 (如. "image/jpeg, image/png"). 不區(qū)分大小寫,默認(rèn)為 null, 意味著所有的文件擴展名是允許的.
minSize: 上傳文件的最小字節(jié)數(shù) 未設(shè)不做判斷.
maxSize: 上傳文件的較大字節(jié)數(shù) 未設(shè)不做判斷.
maxFiles: 較大的上傳文件數(shù) 默認(rèn)為 1, 意味著只能上傳單個文件對于單個文件上傳框. 如果大于 1, 那么 input必須是一個 array 包含至多 maxFiles 數(shù)量的上傳文件.
checkExtensionByMimeType: 是否檢查文件的擴展名. 如果由MIME類型檢查所產(chǎn)生的擴展不同于上傳的文件擴展名,該文件將被認(rèn)為是無效的。默認(rèn)值為true,意思進行這樣的檢查。
FileValidator 和 yii\web\UploadedFile 一起使用. .
文件上傳請參考:http://www.yiiframework.com/doc-2.0/guide-input-file-upload.html
10. filter 過濾
<?php [ // 去掉 "username" 和 "email" 輸入空格 跳過數(shù)組驗證 [['username', 'email'], 'filter', 'filter' => 'trim', 'skipOnArray' => true], // 驗證正常 "phone" 輸入 ['phone', 'filter', 'filter' => function ($value) { // 驗證正確性手機代碼 return $value; }], ] ?>
這個驗證器驗證不了數(shù)據(jù). 相反的, it applies a filter on the input value and assigns it back to the attribute being validated.
filter: 一個php回調(diào)函數(shù)定義一個filter. 他可能是一個全局函數(shù)的名字, 一個匿名函數(shù)等等. 函數(shù)的原型一定是<?php function ($value) { return $newValue; } ?>這個屬性必須設(shè)置.
skipOnArray: 當(dāng)輸入只是一個數(shù)組的時候是否跳過.默認(rèn)是 false. 請注意,如果過濾器無法處理數(shù)組輸入,您應(yīng)該將此屬性設(shè)置為true。否則,可能會發(fā)生一些PHP錯誤.
小提示: 去空格直接用trim驗證.
小提示: 部分封裝可以直接使用系統(tǒng)函數(shù)如intval:
<?php ['property', 'filter', 'filter' => 'boolval'], ['property', 'filter', 'filter' => 'intval'], ?>
11. image 圖片
<?php [ // 檢查 "primaryImage" 是否是一個有效的圖片 且大小合適 ['primaryImage', 'image', 'extensions' => 'png, jpg', 'minWidth' => 100, 'maxWidth' => 1000, 'minHeight' => 100, 'maxHeight' => 1000, ], ] ?>
文件驗證器的擴展:
minWidth: 最小的寬度 不設(shè)無限制.
maxWidth: 較大的寬度 不設(shè)無限制.
minHeight: 最小的高度 不設(shè)無限制.
maxHeight: 較大的高度 不設(shè)無限制.
12. in 在那一個數(shù)組里面的值
<?php [ // 檢查 "level" 是 1, 2 或 3 ['level', 'in', 'range' => [1, 2, 3]], ] ?>
檢查輸入的值是否存在于給定的系列值的列表中.
range: 給定范圍值的列表.
strict: 輸入值和給定值之間的比較結(jié)果是否應(yīng)嚴(yán)格(的類型和值必須相同)。默認(rèn)為false。
not: 驗證結(jié)果是否應(yīng)該被反轉(zhuǎn)。默認(rèn)為false。當(dāng)此屬性設(shè)置為true,驗證檢查,輸入的值不能是給定列表的值中.
allowArray: 是否允許輸入值是一個數(shù)組。如果這是真的,并輸入值是一個數(shù)組,數(shù)組中的每個元素必須值的給定列表中找到,或驗證會失敗。
13. integer 整型驗證
<?php [ // 檢查 "age" 是一個整型值 ['age', 'integer'], ] ?>
max: 上限 不設(shè)不檢查.
min: 下限 不設(shè)不檢查..
14. match 正則匹配檢查
<?php [ // 檢查 "username" 以字母開頭,并且只包含文字字符 ['username', 'match', 'pattern' => '/^[a-z]\w*$/i'] ] ?>
輸入值指定的正則表達(dá)式匹配驗證檢查.
pattern: 輸入值必須匹配的規(guī)則. 屬性必須設(shè)置,否則將會拋出異常.
not: 是否反轉(zhuǎn)驗證結(jié)果. 默認(rèn) false.
15. number 數(shù)字檢查
<?php [ // 檢查 "salary" 是一個數(shù)字 ['salary', 'number'], ] ?>
相當(dāng)于double驗證器.
max: 上限 不設(shè)不檢查.
min: 下限 不設(shè)不檢查.
16. required 是否為空檢查
<?php [ // 檢查 "username" 和 "password" 不是空的 [['username', 'password'], 'required'], ] ?>
該驗證器阻止用戶提交空的表單數(shù)據(jù).
requiredValue: 應(yīng)該輸入的值. 如果未設(shè) 意味著輸入值 不應(yīng)該為空.
strict: 驗證一個值時是否應(yīng)該檢查數(shù)據(jù)類型. 默認(rèn)false.當(dāng) requiredValue未設(shè)置時,如果這個屬性是 true, 驗證器會檢查輸入值不嚴(yán)格null;如果改屬性false,驗證器將使用一個松散的規(guī)則來確定一個值是空的或不. 當(dāng) requiredValue設(shè)置了,輸入和requiredValue之間的比較也將檢查數(shù)據(jù)類型,如果此屬性為true。
17. safe 標(biāo)記輸入是安全屬性
<?php [ // 標(biāo)記 "description" 是一個 safe 的屬性 ['description', 'safe'], ] ?>
這個驗證器不會執(zhí)行數(shù)據(jù)驗證.相反, 它是用來標(biāo)記的屬性是一個安全屬性(我猜作用是不會進行字符轉(zhuǎn)義吧)。
18. string 字符串驗證
<?php [ // 檢查 "username"是一個 string 而且長度在 4 和 24 之間 ['username', 'string', 'length' => [4, 24]], ] ?>
這個驗證器檢查輸入的值是一個字符串且長度在確定的值的范圍里。
length: 指定待驗證的字符串的長度. 可以指定以下形式:
一個整數(shù): 字符串的精確長度;
單個數(shù)組元素: 輸入的最小長度 (e.g. [8]). 必須超過或等于這個數(shù)
兩個數(shù)組元素: 輸入的最小長度和較大長度 (e.g. [8, 128]).
min: 輸入字符串的最小長度 未設(shè)不限制.
max: 輸入字符串的較大長度 未設(shè)不限制..
encoding: 輸入字符串的編碼 未設(shè)默認(rèn) UTF-8.
19. trim 去空格
<?php [ // 去掉 "username" 和 "email" 兩邊的空格 [['username', 'email'], 'trim'], ] ?>
不進行數(shù)據(jù)驗證 只進行去空格 如果屬性是一個數(shù)組 將會自動忽略此過濾.
20. unique 性驗證
<?php [ // a1 需要是在由“a1”屬性表示的列中的 ['a1', 'unique'], // a1 必須是的,但列a2將用于檢查的a1值的性 ['a1', 'unique', 'targetAttribute' => 'a2'], // a1和a2的需要是的,并且它們都將收到錯誤消息 [['a1', 'a2'], 'unique', 'targetAttribute' => ['a1', 'a2']], // a1和a2的需要是的,只有a1將收到錯誤消息 ['a1', 'unique', 'targetAttribute' => ['a1', 'a2']], // a1需要通過檢查的兩個a2和a3的性(使用a1的值)是的 ['a1', 'unique', 'targetAttribute' => ['a2', 'a1' => 'a3']], ] ?>
這驗證檢查,如果輸入的值是表列中的。它僅適用于活動記錄模型的屬性。它支持驗證對任何單個列或多個列。
targetClass: 應(yīng)該是被用于驗證查找輸入值的活動記錄類的名字。如果沒有設(shè)置,將要使用的類目前正在驗證該模型的.
targetAttribute: 應(yīng)該用來驗證輸入值的性在targetClass的屬性的名稱。如果沒有設(shè)置,將使用目前正在驗證的屬性的名稱??梢允褂藐嚵衼眚炞C多列的性的同時。數(shù)組的值是將被用于驗證性的屬性,而數(shù)組鍵是其值要驗證的屬性。如果鍵和值都是一樣的,你可以指定的值。
filter: a額外的過濾器被應(yīng)用到用于檢查輸入值的性的數(shù)據(jù)庫查詢。這可以是一個字符串或代表附加查詢條件的數(shù)組(參考 yii\db\Query::where() 查詢條件的格式), 或者是一個匿名函數(shù)像: function ($query), 其中$query是你可以在函數(shù)修改查詢對象。
/tupian/20230522/yii-db-query url 地址驗證
<?php [ // 檢查 "website" 是一個有效的 URL. 前置 "http://" 到 "website" 屬性 // 如果它不具有一個URI模式 ['website', 'url', 'defaultScheme' => 'http'], ] ?>
validSchemes: 一個數(shù)組指定URI方案應(yīng)被認(rèn)為有效。默認(rèn)為['HTTP','HTTPS'],意思是HTTP和HTTPS URL被認(rèn)為是有效的。
defaultScheme: 默認(rèn)URI方案要預(yù)先考慮到輸入,如果它不具有方案的一部分。默認(rèn)為null,意味著不修改輸入值。
enableIDN:驗證是否應(yīng)考慮到IDN(國際化域名)。默認(rèn)為false。需要注意的是,為了使用IDN驗證您必須安裝并啟用國際PHP擴展,否則異常將會被拋出。
以上是“Yii核心驗證器api的示例分析”這篇文章的所有內(nèi)容,感謝各位的閱讀!相信大家都有了一定的了解,希望分享的內(nèi)容對大家有所幫助,如果還想學(xué)習(xí)更多知識,歡迎關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道!
新聞標(biāo)題:Yii核心驗證器api的示例分析-創(chuàng)新互聯(lián)
文章位置:http://m.rwnh.cn/article30/iidpo.html
成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供Google、微信小程序、網(wǎng)站維護、全網(wǎng)營銷推廣、電子商務(wù)、標(biāo)簽優(yōu)化
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時需注明來源: 創(chuàng)新互聯(lián)
猜你還喜歡下面的內(nèi)容