CExistValidator
鍖 | system.validators |
---|---|
缁ф壙 | class CExistValidator » CValidator » CComponent |
鐗堟湰 | $Id: CExistValidator.php 3549 2012-01-27 15:36:43Z qiang.xue $ |
婧愮爜 | framework/validators/CExistValidator.php |
CExistValidator楠岃瘉灞炴у煎湪鏁版嵁搴撲腑鏄惁瀛樺湪銆
姝ら獙璇佸櫒閫氬父鐢ㄤ簬妫楠屼竴涓閿殑鍊煎湪澶栭敭鍙傜収 琛ㄤ腑宸茬粡瀛樺湪銆
褰撲娇鐢message灞炴у畾涔変簡涓涓嚜瀹氫箟閿欒鎻愮ず淇℃伅锛 姝や俊鎭彲浠ュ寘鍚檮鍔犵殑鍗犱綅绗︼紝鍗犱綅绗﹀彲浠ヨ瀹為檯鍐呭鏇挎崲銆 闄や簡鍙互琚墍鏈夐獙璇佸櫒璇嗗埆鐨"{attribute}"鍗犱綅绗﹀锛堝弬瑙CValidator锛夛紝 CExistValidator杩樺厑璁告寚瀹氫笅鍒楀崰浣嶇锛
姝ら獙璇佸櫒閫氬父鐢ㄤ簬妫楠屼竴涓閿殑鍊煎湪澶栭敭鍙傜収 琛ㄤ腑宸茬粡瀛樺湪銆
褰撲娇鐢message灞炴у畾涔変簡涓涓嚜瀹氫箟閿欒鎻愮ず淇℃伅锛 姝や俊鎭彲浠ュ寘鍚檮鍔犵殑鍗犱綅绗︼紝鍗犱綅绗﹀彲浠ヨ瀹為檯鍐呭鏇挎崲銆 闄や簡鍙互琚墍鏈夐獙璇佸櫒璇嗗埆鐨"{attribute}"鍗犱綅绗﹀锛堝弬瑙CValidator锛夛紝 CExistValidator杩樺厑璁告寚瀹氫笅鍒楀崰浣嶇锛
- {value}: 浣跨敤灞炴у兼浛鎹€
鍏叡灞炴
灞炴 | 绫诲瀷 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|---|
allowEmpty | boolean | 鏄惁姝ゅ睘鎬у煎彲浠ヤ负null鎴杄mpty銆傞粯璁ゅ间负true锛 琛ㄧず濡傛姝ゅ睘鎬т负绌猴紝瀹冨皢閫氳繃楠岃瘉銆 | CExistValidator |
attributeName | string | 鍦ㄥ叾涓绱㈡灞炴у兼槸鍚﹀瓨鍦ㄧ殑 娲诲姩璁板綍绫荤殑灞炴х殑鍚嶅瓧銆傞粯璁ゅ间负null锛 琛ㄧず浣跨敤琚獙璇佺殑灞炴х殑鍚嶅瓧銆 | CExistValidator |
attributes | array | 闇瑕佽楠岃瘉鐨勫睘鎬х殑鍒楄〃銆 | CValidator |
builtInValidators | array | 鍐呯疆楠岃瘉鍣ㄥ垪琛 (name=>class) | CValidator |
className | string | 鍦ㄥ叾涓绱㈡灞炴у兼槸鍚﹀瓨鍦ㄧ殑 娲诲姩璁板綍绫荤殑鍚嶅瓧銆傞粯璁ゅ间负null锛 琛ㄧず浣跨敤琚獙璇佺殑灞炴ф墍灞炵殑娲诲姩璁板綍绫汇 浣犲彲浠ュ湪姝や娇鐢ㄨ矾寰勫埆鍚嶆寚瀹氫竴涓被銆 | CExistValidator |
criteria | array | 闄勫姞鐨勬煡璇㈡潯浠躲傚畠涓庣敤浜庢娴嬪搴旂殑琛 鍜屽垪鏄惁瀛樺湪灞炴у肩殑鏉′欢缁勫悎鎴愪负鏈缁堢殑鏌ヨ鏉′欢銆 姝ゆ暟缁勭敤浜庡疄渚嬪寲涓涓CDbCriteria瀵硅薄銆 | CExistValidator |
enableClientValidation | boolean | 鏄惁鎵ц瀹㈡埛绔獙璇併傞粯璁ゅ间负true銆 鍙傝CActiveForm::enableClientValidation浠ヤ簡瑙f洿澶氬叧浜庡鎴风楠岃瘉鐨勭粏鑺傘 | CValidator |
message | string | 鐢ㄦ埛鑷畾涔夌殑閿欒鎻愮ず淇℃伅銆備笉鍚岀殑楠岃瘉鍣ㄥ彲浠ュ湪璇ヤ俊鎭腑 瀹氫箟鍚勭鍗犱綅绗︼紙灏嗚瀹為檯鍊兼浛鎹級銆傚崰浣嶇鈥渰attribute}鈥濆彲浠ヨ鎵鏈 楠岃瘉鍣ㄨ瘑鍒紝瀹冧細琚娇鐢ㄥ睘鎬х殑鏍囩鏉ユ浛鎹€ | CValidator |
on | array | 楠岃瘉鍣ㄥ皢琚簲鐢ㄥ埌鐨勬儏鏅ā寮忕殑鍒楄〃銆 鏁扮粍鐨勯敭-鍊奸兘鏄儏鏅ā寮忕殑鍚嶇О銆 | CValidator |
safe | boolean | 杩涜鏁村潡璧嬪兼槸鏄惁鑰冭檻姝ら獙璇佸櫒涓垪鍑虹殑灞炴х殑瀹夊叏鎬с 榛樿鍊间负true銆 | CValidator |
skipOnError | boolean | 濡傛灉褰撳墠灞炴у凡缁忓瓨鍦ㄩ獙璇侀敊璇紝杩欎釜楠岃瘉瑙勫垯 鏄惁璺宠繃銆傞粯璁ゅ兼槸false銆 | CValidator |
鍏叡鏂规硶
鍙椾繚鎶ゆ柟娉
鏂规硶 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|
addError() | 娣诲姞鍏充簬鎸囧畾灞炴х殑涓涓敊璇彁绀轰俊鎭埌娲诲姩璁板綍涓 | CValidator |
isEmpty() | 妫娴嬬粰瀹氬兼槸鍚︿负绌恒 | CValidator |
validateAttribute() | 楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с | CExistValidator |
灞炴ц缁
allowEmpty
灞炴
public boolean $allowEmpty;
鏄惁姝ゅ睘鎬у煎彲浠ヤ负null鎴杄mpty銆傞粯璁ゅ间负true锛 琛ㄧず濡傛姝ゅ睘鎬т负绌猴紝瀹冨皢閫氳繃楠岃瘉銆
attributeName
灞炴
public string $attributeName;
鍦ㄥ叾涓绱㈡灞炴у兼槸鍚﹀瓨鍦ㄧ殑 娲诲姩璁板綍绫荤殑灞炴х殑鍚嶅瓧銆傞粯璁ゅ间负null锛 琛ㄧず浣跨敤琚獙璇佺殑灞炴х殑鍚嶅瓧銆
鍙傝
className
灞炴
public string $className;
鍦ㄥ叾涓绱㈡灞炴у兼槸鍚﹀瓨鍦ㄧ殑 娲诲姩璁板綍绫荤殑鍚嶅瓧銆傞粯璁ゅ间负null锛 琛ㄧず浣跨敤琚獙璇佺殑灞炴ф墍灞炵殑娲诲姩璁板綍绫汇 浣犲彲浠ュ湪姝や娇鐢ㄨ矾寰勫埆鍚嶆寚瀹氫竴涓被銆
鍙傝
criteria
灞炴
public array $criteria;
闄勫姞鐨勬煡璇㈡潯浠躲傚畠涓庣敤浜庢娴嬪搴旂殑琛 鍜屽垪鏄惁瀛樺湪灞炴у肩殑鏉′欢缁勫悎鎴愪负鏈缁堢殑鏌ヨ鏉′欢銆 姝ゆ暟缁勭敤浜庡疄渚嬪寲涓涓CDbCriteria瀵硅薄銆
鏂规硶璇︾粏
validateAttribute()
鏂规硶
protected void validateAttribute(CModel $object, string $attribute)
| ||
$object | CModel | 闇瑕侀獙璇佺殑瀵硅薄 |
$attribute | string | 闇瑕侀獙璇佺殑灞炴 |
婧愮爜锛 framework/validators/CExistValidator.php#64 (鏄剧ず)
protected function validateAttribute($object,$attribute)
{
$value=$object->$attribute;
if($this->allowEmpty && $this->isEmpty($value))
return;
$className=$this->className===null?get_class($object):Yii::import($this->className);
$attributeName=$this->attributeName===null?$attribute:$this->attributeName;
$finder=CActiveRecord::model($className);
$table=$finder->getTableSchema();
if(($column=$table->getColumn($attributeName))===null)
throw new CException(Yii::t('yii','Table "{table}" does not have a column named "{column}".',
array('{column}'=>$attributeName,'{table}'=>$table->name)));
$criteria=array('condition'=>$column->rawName.'=:vp','params'=>array(':vp'=>$value));
if($this->criteria!==array())
{
$criteria=new CDbCriteria($criteria);
$criteria->mergeWith($this->criteria);
}
if(!$finder->exists($criteria))
{
$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} "{value}" is invalid.');
$this->addError($object,$attribute,$message,array('{value}'=>CHtml::encode($value)));
}
}
楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с 濡傛灉瀛樺湪浠讳綍楠岃瘉閿欒锛屾閿欒鐨勬彁绀轰俊鎭皢琚坊鍔犲埌姝ゅ璞′腑銆