CEmailValidator
鍖 | system.validators |
---|---|
缁ф壙 | class CEmailValidator » CValidator » CComponent |
婧愯嚜 | 1.0 |
鐗堟湰 | $Id: CEmailValidator.php 3515 2011-12-28 12:29:24Z mdomba $ |
婧愮爜 | framework/validators/CEmailValidator.php |
CEmailValidator楠岃瘉姝ゅ睘鎬у兼槸鍚︿竴涓湁鏁堢殑email鍦板潃銆
鍏叡灞炴
灞炴 | 绫诲瀷 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|---|
allowEmpty | boolean | 姝ゅ睘鎬у兼槸鍚﹀彲浠ヤ负null鎴杄mpty銆傞粯璁ゅ兼槸true锛 琛ㄧず濡傛灉姝ゅ睘鎬у间负绌烘椂瀹冨皢閫氳繃楠岃瘉銆 | CEmailValidator |
allowName | boolean | 鏄惁鍏佽鍦╡mail鍦板潃涓寘鍚鍚嶏紙渚嬪锛"Qiang Xue CEmailValidator |
|
attributes | array | 闇瑕佽楠岃瘉鐨勫睘鎬х殑鍒楄〃銆 | CValidator |
builtInValidators | array | 鍐呯疆楠岃瘉鍣ㄥ垪琛 (name=>class) | CValidator |
checkMX | boolean | 鏄惁妫娴媏mail鍦板潃鐨凪X璁板綍銆 榛樿鍊兼槸false銆傝鍚敤瀹冿紝浣犻渶瑕佺‘淇濅綘鐨凱HP 瀹夎閲屽惈鏈'checkdnsrr'鍑芥暟銆 | CEmailValidator |
checkPort | boolean | 鏄惁鍦ㄧ鍙25妫娴媏mail鍦板潃銆 榛樿鍊兼槸false銆 | CEmailValidator |
enableClientValidation | boolean | 鏄惁鎵ц瀹㈡埛绔獙璇併傞粯璁ゅ间负true銆 鍙傝CActiveForm::enableClientValidation浠ヤ簡瑙f洿澶氬叧浜庡鎴风楠岃瘉鐨勭粏鑺傘 | CValidator |
fullPattern | string | 鐢ㄤ簬楠岃瘉甯︽湁鍚嶅瓧閮ㄥ垎鐨別mail鍦板潃鐨勬鍒欒〃杈惧紡銆 姝ゅ睘鎬т粎褰allowName涓簍rue鏃舵墠浼氳浣跨敤銆 | CEmailValidator |
message | string | 鐢ㄦ埛鑷畾涔夌殑閿欒鎻愮ず淇℃伅銆備笉鍚岀殑楠岃瘉鍣ㄥ彲浠ュ湪璇ヤ俊鎭腑 瀹氫箟鍚勭鍗犱綅绗︼紙灏嗚瀹為檯鍊兼浛鎹級銆傚崰浣嶇鈥渰attribute}鈥濆彲浠ヨ鎵鏈 楠岃瘉鍣ㄨ瘑鍒紝瀹冧細琚娇鐢ㄥ睘鎬х殑鏍囩鏉ユ浛鎹€ | CValidator |
on | array | 楠岃瘉鍣ㄥ皢琚簲鐢ㄥ埌鐨勬儏鏅ā寮忕殑鍒楄〃銆 鏁扮粍鐨勯敭-鍊奸兘鏄儏鏅ā寮忕殑鍚嶇О銆 | CValidator |
pattern | string | 鐢ㄤ簬楠岃瘉灞炴у肩殑姝e垯琛ㄨ揪寮忋 | CEmailValidator |
safe | boolean | 杩涜鏁村潡璧嬪兼槸鏄惁鑰冭檻姝ら獙璇佸櫒涓垪鍑虹殑灞炴х殑瀹夊叏鎬с 榛樿鍊间负true銆 | CValidator |
skipOnError | boolean | 濡傛灉褰撳墠灞炴у凡缁忓瓨鍦ㄩ獙璇侀敊璇紝杩欎釜楠岃瘉瑙勫垯 鏄惁璺宠繃銆傞粯璁ゅ兼槸false銆 | CValidator |
鍏叡鏂规硶
鍙椾繚鎶ゆ柟娉
鏂规硶 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|
addError() | 娣诲姞鍏充簬鎸囧畾灞炴х殑涓涓敊璇彁绀轰俊鎭埌娲诲姩璁板綍涓 | CValidator |
isEmpty() | 妫娴嬬粰瀹氬兼槸鍚︿负绌恒 | CValidator |
validateAttribute() | 楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с | CEmailValidator |
灞炴ц缁
allowEmpty
灞炴
public boolean $allowEmpty;
姝ゅ睘鎬у兼槸鍚﹀彲浠ヤ负null鎴杄mpty銆傞粯璁ゅ兼槸true锛 琛ㄧず濡傛灉姝ゅ睘鎬у间负绌烘椂瀹冨皢閫氳繃楠岃瘉銆
allowName
灞炴
public boolean $allowName;
鏄惁鍏佽鍦╡mail鍦板潃涓寘鍚鍚嶏紙渚嬪锛"Qiang Xue
鍙傝
checkMX
灞炴
public boolean $checkMX;
鏄惁妫娴媏mail鍦板潃鐨凪X璁板綍銆 榛樿鍊兼槸false銆傝鍚敤瀹冿紝浣犻渶瑕佺‘淇濅綘鐨凱HP 瀹夎閲屽惈鏈'checkdnsrr'鍑芥暟銆
checkPort
灞炴
public boolean $checkPort;
鏄惁鍦ㄧ鍙25妫娴媏mail鍦板潃銆 榛樿鍊兼槸false銆
fullPattern
灞炴
public string $fullPattern;
鐢ㄤ簬楠岃瘉甯︽湁鍚嶅瓧閮ㄥ垎鐨別mail鍦板潃鐨勬鍒欒〃杈惧紡銆 姝ゅ睘鎬т粎褰allowName涓簍rue鏃舵墠浼氳浣跨敤銆
鍙傝
pattern
灞炴
public string $pattern;
鐢ㄤ簬楠岃瘉灞炴у肩殑姝e垯琛ㄨ揪寮忋
鏂规硶璇︾粏
clientValidateAttribute()
鏂规硶
锛堝彲鐢ㄨ嚜 v1.1.7锛
public string clientValidateAttribute(CModel $object, string $attribute)
| ||
$object | CModel | 闇瑕侀獙璇佺殑瀵硅薄 |
$attribute | string | 闇瑕侀獙璇佺殑灞炴х殑鍚嶅瓧 |
{return} | string | 瀹㈡埛绔獙璇佽剼鏈 |
婧愮爜锛 framework/validators/CEmailValidator.php#101 (鏄剧ず)
public function clientValidateAttribute($object,$attribute)
{
$message=$this->message!==null ? $this->message : Yii::t('yii','{attribute} is not a valid email address.');
$message=strtr($message, array(
'{attribute}'=>$object->getAttributeLabel($attribute),
));
$condition="!value.match({$this->pattern})";
if($this->allowName)
$condition.=" && !value.match({$this->fullPattern})";
return "
if(".($this->allowEmpty ? "$.trim(value)!='' && " : '').$condition.") {
messages.push(".CJSON::encode($message).");
}
";
}
杩斿洖鎵ц瀹㈡埛绔獙璇佹墍闇鐨凧avascript銆
validateAttribute()
鏂规硶
protected void validateAttribute(CModel $object, string $attribute)
| ||
$object | CModel | 闇瑕侀獙璇佺殑瀵硅薄 |
$attribute | string | 闇瑕侀獙璇佺殑灞炴 |
婧愮爜锛 framework/validators/CEmailValidator.php#60 (鏄剧ず)
protected function validateAttribute($object,$attribute)
{
$value=$object->$attribute;
if($this->allowEmpty && $this->isEmpty($value))
return;
if(!$this->validateValue($value))
{
$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} is not a valid email address.');
$this->addError($object,$attribute,$message);
}
}
楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с 濡傛灉瀛樺湪浠讳綍楠岃瘉閿欒锛岃閿欒鐨勬彁绀轰俊鎭皢琚坊鍔犲埌姝ゅ璞′腑銆
validateValue()
鏂规硶
锛堝彲鐢ㄨ嚜 v1.1.1锛
public boolean validateValue(mixed $value)
| ||
$value | mixed | 闇瑕侀獙璇佺殑鍊 |
{return} | boolean | 楠岃瘉鐨勫兼槸鍚︽湁鏁堢殑email鍦板潃 |
婧愮爜锛 framework/validators/CEmailValidator.php#80 (鏄剧ず)
public function validateValue($value)
{
// 纭繚瀛楃涓茬殑闀垮害鍙楅檺鍒朵互閬垮厤DOS鏀诲嚮
$valid=is_string($value) && strlen($value)<=254 && (preg_match($this->pattern,$value) || $this->allowName && preg_match($this->fullPattern,$value));
if($valid)
$domain=rtrim(substr($value,strpos($value,'@')+1),'>');
if($valid && $this->checkMX && function_exists('checkdnsrr'))
$valid=checkdnsrr($domain,'MX');
if($valid && $this->checkPort && function_exists('fsockopen'))
$valid=fsockopen($domain,25)!==false;
return $valid;
}
楠岃瘉涓涓潤鎬佸兼槸鍚︿竴涓湁鏁堢殑email鍦板潃銆 娉ㄦ剰锛氭鏂规硶涓嶅彈allowEmpty灞炴х殑褰卞搷銆 姝ゆ柟娉曠殑鐩殑鏄娇浣犲彲浠ョ畝鍗曞湴鐩存帴璋冪敤瀹冭屼笉鐢ㄩ氳繃妯″瀷楠岃瘉瑙勫垯鏈哄埗銆