CTypeValidator
鍖 | system.validators |
---|---|
缁ф壙 | class CTypeValidator » CValidator » CComponent |
婧愯嚜 | 1.0 |
鐗堟湰 | $Id: CTypeValidator.php 3515 2011-12-28 12:29:24Z mdomba $ |
婧愮爜 | framework/validators/CTypeValidator.php |
CTypeValidator楠岃瘉灞炴х殑绫诲瀷鏄惁涓type鎵鎸囧畾鐨勭被鍨.
浠ヤ笅鏁版嵁绫诲瀷鍙楀埌鏀寔锛
瀵逛簬date绫诲瀷锛岄渶瑕佷娇鐢dateFormat 鏉ョ‘瀹氭棩鏈熷瓧绗︿覆鐨勮В鏋愭柟寮忋傚鏋滅粰瀹氱殑鏃ユ湡鍊间笌棰勬湡 鐨勬牸寮忎笉鍖归厤锛屾灞炴у皢涓嶈兘閫氳繃楠岃瘉銆
浠1.1.7鐗堝紑濮嬶紝鎴戜滑鏈変簡涓涓笓鐢ㄧ殑鏃ユ湡楠岃瘉鍣CDateValidator锛 璇疯冭檻浣跨敤璇ラ獙璇佸櫒鏉ラ獙璇佷竴涓棩鏈熺被鍨嬬殑鍊笺
褰撲娇鐢message灞炴у畾涔変竴涓嚜瀹氫箟閿欒鎻愮ず淇℃伅鏃讹紝 鍙互鍦ㄥ叾涓寘鍚澶栫殑鍗犱綅绗︼紝鍗犱綅绗﹀彲浠ヨ瀹為檯鍐呭鏇挎崲銆傞櫎浜嗘墍鏈 楠岃瘉鍣ㄥ潎鍙瘑鍒殑 "{attribute}" 鍗犱綅绗(鍙傝CValidator)澶栵紝 CTypeValidator杩樺厑璁告寚瀹氫笅鍒楀崰浣嶇锛
浠ヤ笅鏁版嵁绫诲瀷鍙楀埌鏀寔锛
- integer鏈夌鍙锋暣鏁般
- float鍙岀簿搴︽诞鐐规暟銆
- string瀛楃涓层
- array鏁扮粍銆
- date鏃ユ湡鍨嬨
- time鏃堕棿鍨嬨
- datetime鏃ユ湡鏃堕棿鍨嬨
瀵逛簬date绫诲瀷锛岄渶瑕佷娇鐢dateFormat 鏉ョ‘瀹氭棩鏈熷瓧绗︿覆鐨勮В鏋愭柟寮忋傚鏋滅粰瀹氱殑鏃ユ湡鍊间笌棰勬湡 鐨勬牸寮忎笉鍖归厤锛屾灞炴у皢涓嶈兘閫氳繃楠岃瘉銆
浠1.1.7鐗堝紑濮嬶紝鎴戜滑鏈変簡涓涓笓鐢ㄧ殑鏃ユ湡楠岃瘉鍣CDateValidator锛 璇疯冭檻浣跨敤璇ラ獙璇佸櫒鏉ラ獙璇佷竴涓棩鏈熺被鍨嬬殑鍊笺
褰撲娇鐢message灞炴у畾涔変竴涓嚜瀹氫箟閿欒鎻愮ず淇℃伅鏃讹紝 鍙互鍦ㄥ叾涓寘鍚澶栫殑鍗犱綅绗︼紝鍗犱綅绗﹀彲浠ヨ瀹為檯鍐呭鏇挎崲銆傞櫎浜嗘墍鏈 楠岃瘉鍣ㄥ潎鍙瘑鍒殑 "{attribute}" 鍗犱綅绗(鍙傝CValidator)澶栵紝 CTypeValidator杩樺厑璁告寚瀹氫笅鍒楀崰浣嶇锛
- {type}: 浣跨敤灞炴ф墍鏈熸湜鐨勭被鍨type鏇挎崲銆
鍏叡灞炴
灞炴 | 绫诲瀷 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|---|
allowEmpty | boolean | 鏄惁姝ゅ睘鎬у煎厑璁镐负null鎴杄mpty銆傞粯璁ゅ兼槸true锛 琛ㄧず濡傛灉姝ゅ睘鎬у间负绌烘椂瀹冨皢閫氳繃楠岃瘉銆 | CTypeValidator |
attributes | array | 闇瑕佽楠岃瘉鐨勫睘鎬х殑鍒楄〃銆 | CValidator |
builtInValidators | array | 鍐呯疆楠岃瘉鍣ㄥ垪琛 (name=>class) | CValidator |
dateFormat | string | 鍖归厤鏃ユ湡鏍煎紡鐨勬ā鏉裤傞粯璁ゅ兼槸 'MM/dd/yyyy'銆 璇峰弬瑙CDateTimeParser浠ヤ簡瑙e浣曟寚瀹氫竴涓棩鏈熸牸寮忕殑鏇村缁嗚妭銆 浠呭綋type璁剧疆涓"date"鏃讹紝杩欎釜鍊兼墠浼氱敓鏁堛 | CTypeValidator |
datetimeFormat | string | 鍖归厤鏃ユ湡鏃堕棿鏍煎紡鐨勬ā鏉裤傞粯璁ゅ兼槸 'MM/dd/yyyy hh:mm'銆 璇峰弬瑙CDateTimeParser浠ヤ簡瑙e浣曟寚瀹氫竴涓棩鏈熸椂闂存牸寮忕殑鏇村缁嗚妭銆 浠呭綋type璁剧疆涓"datetime"鏃讹紝杩欎釜鍊兼墠浼氱敓鏁堛 | CTypeValidator |
enableClientValidation | boolean | 鏄惁鎵ц瀹㈡埛绔獙璇併傞粯璁ゅ间负true銆 鍙傝CActiveForm::enableClientValidation浠ヤ簡瑙f洿澶氬叧浜庡鎴风楠岃瘉鐨勭粏鑺傘 | CValidator |
message | string | 鐢ㄦ埛鑷畾涔夌殑閿欒鎻愮ず淇℃伅銆備笉鍚岀殑楠岃瘉鍣ㄥ彲浠ュ湪璇ヤ俊鎭腑 瀹氫箟鍚勭鍗犱綅绗︼紙灏嗚瀹為檯鍊兼浛鎹級銆傚崰浣嶇鈥渰attribute}鈥濆彲浠ヨ鎵鏈 楠岃瘉鍣ㄨ瘑鍒紝瀹冧細琚娇鐢ㄥ睘鎬х殑鏍囩鏉ユ浛鎹€ | CValidator |
on | array | 楠岃瘉鍣ㄥ皢琚簲鐢ㄥ埌鐨勬儏鏅ā寮忕殑鍒楄〃銆 鏁扮粍鐨勯敭-鍊奸兘鏄儏鏅ā寮忕殑鍚嶇О銆 | CValidator |
safe | boolean | 杩涜鏁村潡璧嬪兼槸鏄惁鑰冭檻姝ら獙璇佸櫒涓垪鍑虹殑灞炴х殑瀹夊叏鎬с 榛樿鍊间负true銆 | CValidator |
skipOnError | boolean | 濡傛灉褰撳墠灞炴у凡缁忓瓨鍦ㄩ獙璇侀敊璇紝杩欎釜楠岃瘉瑙勫垯 鏄惁璺宠繃銆傞粯璁ゅ兼槸false銆 | CValidator |
timeFormat | string | 鍖归厤鏃ユ湡鏍煎紡鐨勬ā鏉裤傞粯璁ゅ兼槸 'hh:mm'銆 璇峰弬瑙CDateTimeParser浠ヤ簡瑙e浣曟寚瀹氫竴涓椂闂存牸寮忕殑鏇村缁嗚妭銆 浠呭綋type璁剧疆涓"time"鏃讹紝杩欎釜鍊兼墠浼氱敓鏁堛 | CTypeValidator |
type | string | 灞炴у兼湡鏈涚殑鏁版嵁绫诲瀷銆傞粯璁ゅ兼槸鈥渟tring鈥濄 鏈夋晥鐨勫煎寘鎷 'string', 'integer', 'float', 'array', 'date', 'time' 鍜 'datetime'銆 | CTypeValidator |
鍏叡鏂规硶
鍙椾繚鎶ゆ柟娉
鏂规硶 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|
addError() | 娣诲姞鍏充簬鎸囧畾灞炴х殑涓涓敊璇彁绀轰俊鎭埌娲诲姩璁板綍涓 | CValidator |
isEmpty() | 妫娴嬬粰瀹氬兼槸鍚︿负绌恒 | CValidator |
validateAttribute() | 楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с | CTypeValidator |
灞炴ц缁
allowEmpty
灞炴
public boolean $allowEmpty;
鏄惁姝ゅ睘鎬у煎厑璁镐负null鎴杄mpty銆傞粯璁ゅ兼槸true锛 琛ㄧず濡傛灉姝ゅ睘鎬у间负绌烘椂瀹冨皢閫氳繃楠岃瘉銆
dateFormat
灞炴
public string $dateFormat;
鍖归厤鏃ユ湡鏍煎紡鐨勬ā鏉裤傞粯璁ゅ兼槸 'MM/dd/yyyy'銆 璇峰弬瑙CDateTimeParser浠ヤ簡瑙e浣曟寚瀹氫竴涓棩鏈熸牸寮忕殑鏇村缁嗚妭銆 浠呭綋type璁剧疆涓"date"鏃讹紝杩欎釜鍊兼墠浼氱敓鏁堛
datetimeFormat
灞炴
public string $datetimeFormat;
鍖归厤鏃ユ湡鏃堕棿鏍煎紡鐨勬ā鏉裤傞粯璁ゅ兼槸 'MM/dd/yyyy hh:mm'銆 璇峰弬瑙CDateTimeParser浠ヤ簡瑙e浣曟寚瀹氫竴涓棩鏈熸椂闂存牸寮忕殑鏇村缁嗚妭銆 浠呭綋type璁剧疆涓"datetime"鏃讹紝杩欎釜鍊兼墠浼氱敓鏁堛
timeFormat
灞炴
public string $timeFormat;
鍖归厤鏃ユ湡鏍煎紡鐨勬ā鏉裤傞粯璁ゅ兼槸 'hh:mm'銆 璇峰弬瑙CDateTimeParser浠ヤ簡瑙e浣曟寚瀹氫竴涓椂闂存牸寮忕殑鏇村缁嗚妭銆 浠呭綋type璁剧疆涓"time"鏃讹紝杩欎釜鍊兼墠浼氱敓鏁堛
type
灞炴
public string $type;
灞炴у兼湡鏈涚殑鏁版嵁绫诲瀷銆傞粯璁ゅ兼槸鈥渟tring鈥濄 鏈夋晥鐨勫煎寘鎷 'string', 'integer', 'float', 'array', 'date', 'time' 鍜 'datetime'銆
鏂规硶璇︾粏
validateAttribute()
鏂规硶
protected void validateAttribute(CModel $object, string $attribute)
| ||
$object | CModel | 闇瑕侀獙璇佺殑瀵硅薄 |
$attribute | string | 闇瑕侀獙璇佺殑灞炴 |
婧愮爜锛 framework/validators/CTypeValidator.php#82 (鏄剧ず)
protected function validateAttribute($object,$attribute)
{
$value=$object->$attribute;
if($this->allowEmpty && $this->isEmpty($value))
return;
if($this->type==='integer')
$valid=preg_match('/^[-+]?[0-9]+$/',trim($value));
else if($this->type==='float')
$valid=preg_match('/^[-+]?([0-9]*\.)?[0-9]+([eE][-+]?[0-9]+)?$/',trim($value));
else if($this->type==='date')
$valid=CDateTimeParser::parse($value,$this->dateFormat,array('month'=>1,'day'=>1,'hour'=>0,'minute'=>0,'second'=>0))!==false;
else if($this->type==='time')
$valid=CDateTimeParser::parse($value,$this->timeFormat)!==false;
else if($this->type==='datetime')
$valid=CDateTimeParser::parse($value,$this->datetimeFormat, array('month'=>1,'day'=>1,'hour'=>0,'minute'=>0,'second'=>0))!==false;
else if($this->type==='array')
$valid=is_array($value);
else
return;
if(!$valid)
{
$message=$this->message!==null?$this->message : Yii::t('yii','{attribute} must be {type}.');
$this->addError($object,$attribute,$message,array('{type}'=>$this->type));
}
}
楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с 濡傛灉瀛樺湪浠讳綍楠岃瘉閿欒锛岄敊璇彁绀轰俊鎭皢琚坊鍔犲埌姝ゅ璞′腑銆