CUrlValidator
鍖 | system.validators |
---|---|
缁ф壙 | class CUrlValidator » CValidator » CComponent |
婧愯嚜 | 1.0 |
鐗堟湰 | $Id: CUrlValidator.php 3242 2011-05-28 14:31:04Z qiang.xue $ |
婧愮爜 | framework/validators/CUrlValidator.php |
CUrlValidator楠岃瘉灞炴у兼槸涓涓湁鏁堢殑http鎴杊ttps鍦板潃銆
鍏叡灞炴
灞炴 | 绫诲瀷 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|---|
allowEmpty | boolean | 姝ゅ睘鎬у兼槸鍚﹀彲浠ヤ负null鎴杄mpty銆傞粯璁ゅ兼槸true锛 琛ㄧず濡傛灉姝ゅ睘鎬у间负绌烘椂灏嗛氳繃楠岃瘉銆 | CUrlValidator |
attributes | array | 闇瑕佽楠岃瘉鐨勫睘鎬х殑鍒楄〃銆 | CValidator |
builtInValidators | array | 鍐呯疆楠岃瘉鍣ㄥ垪琛 (name=>class) | CValidator |
defaultScheme | string | 榛樿鐨刄RI鏂规锛坰cheme锛夈傚鏋滅敤鎴风殑杈撳叆涓嶅寘鍚柟妗堥儴浠斤紝 榛樿鏂规灏嗛檮浜庡叾涓婏紙浠庤屾敼鍙樼敤鎴风殑杈撳叆锛夈傞粯璁ゅ兼槸null锛岃〃绀 涓涓猆RL蹇呴』鍖呭惈鏂规閮ㄥ垎銆 | CUrlValidator |
enableClientValidation | boolean | 鏄惁鎵ц瀹㈡埛绔獙璇併傞粯璁ゅ间负true銆 鍙傝CActiveForm::enableClientValidation浠ヤ簡瑙f洿澶氬叧浜庡鎴风楠岃瘉鐨勭粏鑺傘 | CValidator |
message | string | 鐢ㄦ埛鑷畾涔夌殑閿欒鎻愮ず淇℃伅銆備笉鍚岀殑楠岃瘉鍣ㄥ彲浠ュ湪璇ヤ俊鎭腑 瀹氫箟鍚勭鍗犱綅绗︼紙灏嗚瀹為檯鍊兼浛鎹級銆傚崰浣嶇鈥渰attribute}鈥濆彲浠ヨ鎵鏈 楠岃瘉鍣ㄨ瘑鍒紝瀹冧細琚娇鐢ㄥ睘鎬х殑鏍囩鏉ユ浛鎹€ | CValidator |
on | array | 楠岃瘉鍣ㄥ皢琚簲鐢ㄥ埌鐨勬儏鏅ā寮忕殑鍒楄〃銆 鏁扮粍鐨勯敭-鍊奸兘鏄儏鏅ā寮忕殑鍚嶇О銆 | CValidator |
pattern | string | 鐢ㄤ簬楠岃瘉灞炴у肩殑姝e垯琛ㄨ揪寮忋 浠1. | CUrlValidator |
safe | boolean | 杩涜鏁村潡璧嬪兼槸鏄惁鑰冭檻姝ら獙璇佸櫒涓垪鍑虹殑灞炴х殑瀹夊叏鎬с 榛樿鍊间负true銆 | CValidator |
skipOnError | boolean | 濡傛灉褰撳墠灞炴у凡缁忓瓨鍦ㄩ獙璇侀敊璇紝杩欎釜楠岃瘉瑙勫垯 鏄惁璺宠繃銆傞粯璁ゅ兼槸false銆 | CValidator |
validSchemes | array | 鍙互閫氳繃楠岃瘉鐨刄RI鏂规鐨勫垪琛ㄣ傞粯璁ゆ儏鍐典笅锛 鍖呮嫭http鍜宧ttps銆 | CUrlValidator |
鍏叡鏂规硶
鍙椾繚鎶ゆ柟娉
鏂规硶 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|
addError() | 娣诲姞鍏充簬鎸囧畾灞炴х殑涓涓敊璇彁绀轰俊鎭埌娲诲姩璁板綍涓 | CValidator |
isEmpty() | 妫娴嬬粰瀹氬兼槸鍚︿负绌恒 | CValidator |
validateAttribute() | 楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с | CUrlValidator |
灞炴ц缁
allowEmpty
灞炴
public boolean $allowEmpty;
姝ゅ睘鎬у兼槸鍚﹀彲浠ヤ负null鎴杄mpty銆傞粯璁ゅ兼槸true锛 琛ㄧず濡傛灉姝ゅ睘鎬у间负绌烘椂灏嗛氳繃楠岃瘉銆
defaultScheme
灞炴
锛堝彲鐢ㄨ嚜 v1.1.7锛
public string $defaultScheme;
榛樿鐨刄RI鏂规锛坰cheme锛夈傚鏋滅敤鎴风殑杈撳叆涓嶅寘鍚柟妗堥儴浠斤紝 榛樿鏂规灏嗛檮浜庡叾涓婏紙浠庤屾敼鍙樼敤鎴风殑杈撳叆锛夈傞粯璁ゅ兼槸null锛岃〃绀 涓涓猆RL蹇呴』鍖呭惈鏂规閮ㄥ垎銆
pattern
灞炴
public string $pattern;
鐢ㄤ簬楠岃瘉灞炴у肩殑姝e垯琛ㄨ揪寮忋 浠1.1.7鐗堝紑濮嬶紝姝ゆā鏉垮彲浠ュ寘鍚竴涓獅schemes}浠ょ墝锛屽畠灏嗚涓涓 琛ㄧず{@see validSchemes}鐨勬鍒欒〃杈惧紡鏇挎崲銆
validSchemes
灞炴
锛堝彲鐢ㄨ嚜 v1.1.7锛
public array $validSchemes;
鍙互閫氳繃楠岃瘉鐨刄RI鏂规鐨勫垪琛ㄣ傞粯璁ゆ儏鍐典笅锛 鍖呮嫭http鍜宧ttps銆
鏂规硶璇︾粏
clientValidateAttribute()
鏂规硶
锛堝彲鐢ㄨ嚜 v1.1.7锛
public string clientValidateAttribute(CModel $object, string $attribute)
| ||
$object | CModel | 闇瑕侀獙璇佺殑瀵硅薄 |
$attribute | string | 闇瑕侀獙璇佺殑灞炴х殑鍚嶅瓧 |
{return} | string | 瀹㈡埛绔獙璇佽剼鏈 |
婧愮爜锛 framework/validators/CUrlValidator.php#100 (鏄剧ず)
public function clientValidateAttribute($object,$attribute)
{
$message=$this->message!==null ? $this->message : Yii::t('yii','{attribute} is not a valid URL.');
$message=strtr($message, array(
'{attribute}'=>$object->getAttributeLabel($attribute),
));
if(strpos($this->pattern,'{schemes}')!==false)
$pattern=str_replace('{schemes}','('.implode('|',$this->validSchemes).')',$this->pattern);
else
$pattern=$this->pattern;
$js="
if(!value.match($pattern)) {
messages.push(".CJSON::encode($message).");
}
";
if($this->defaultScheme!==null)
{
$js="
if(!value.match(/:\\/\\//)) {
value=".CJSON::encode($this->defaultScheme)."+'://'+value;
}
$js
";
}
if($this->allowEmpty)
{
$js="
if($.trim(value)!='') {
$js
}
";
}
return $js;
}
杩斿洖鎵ц瀹㈡埛绔獙璇佹墍闇鐨凧avascript銆
validateAttribute()
鏂规硶
protected void validateAttribute(CModel $object, string $attribute)
| ||
$object | CModel | 闇瑕侀獙璇佺殑瀵硅薄 |
$attribute | string | 闇瑕侀獙璇佺殑灞炴 |
婧愮爜锛 framework/validators/CUrlValidator.php#52 (鏄剧ず)
protected function validateAttribute($object,$attribute)
{
$value=$object->$attribute;
if($this->allowEmpty && $this->isEmpty($value))
return;
if(($value=$this->validateValue($value))!==false)
$object->$attribute=$value;
else
{
$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} is not a valid URL.');
$this->addError($object,$attribute,$message);
}
}
楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с 濡傛灉瀛樺湪浠讳綍楠岃瘉閿欒锛岃閿欒鐨勬彁绀轰俊鎭皢琚坊鍔犲埌姝ゅ璞′腑銆
validateValue()
鏂规硶
锛堝彲鐢ㄨ嚜 v1.1.1锛
public boolean validateValue(mixed $value)
| ||
$value | mixed | 闇瑕侀獙璇佺殑鍊 |
{return} | boolean | 濡傛灉姝ゅ间笉鏄竴涓湁鏁堢殑URL鍒欒繑鍥瀎alse锛屽惁鍒欏彲鑳芥槸淇敼杩囩殑鍊硷紙{@see defaultScheme}锛夈 |
婧愮爜锛 framework/validators/CUrlValidator.php#74 (鏄剧ず)
public function validateValue($value)
{
if(is_string($value) && strlen($value)<2000) // make sure the length is limited to avoid DOS attacks
{
if($this->defaultScheme!==null && strpos($value,'://')===false)
$value=$this->defaultScheme.'://'.$value;
if(strpos($this->pattern,'{schemes}')!==false)
$pattern=str_replace('{schemes}','('.implode('|',$this->validSchemes).')',$this->pattern);
else
$pattern=$this->pattern;
if(preg_match($pattern,$value))
return $value;
}
return false;
}
楠岃瘉涓涓潤鎬佸兼槸鍚︿竴涓湁鏁堢殑URL鍦板潃銆 娉ㄦ剰锛氭鏂规硶涓嶅彈allowEmpty灞炴х殑褰卞搷銆 姝ゆ柟娉曠殑鐩殑鏄娇浣犲彲浠ョ畝鍗曞湴鐩存帴璋冪敤瀹冭屼笉鐢ㄩ氳繃妯″瀷楠岃瘉瑙勫垯鏈哄埗銆