CUniqueValidator
鍖 | system.validators |
---|---|
缁ф壙 | class CUniqueValidator » CValidator » CComponent |
婧愯嚜 | 1.0 |
鐗堟湰 | $Id: CUniqueValidator.php 3549 2012-01-27 15:36:43Z qiang.xue $ |
婧愮爜 | framework/validators/CUniqueValidator.php |
CUniqueValidator楠岃瘉灞炴у煎湪鐩稿叧鏁版嵁搴撹〃涓槸鍚﹀敮涓銆
褰撲娇鐢message灞炴у畾涔変簡涓涓嚜瀹氫箟閿欒鎻愮ず淇℃伅锛 姝や俊鎭彲浠ュ寘鍚檮鍔犵殑鍗犱綅绗︼紝鍗犱綅绗﹀彲浠ヨ瀹為檯鍐呭鏇挎崲銆 闄や簡鍙互琚墍鏈夐獙璇佸櫒璇嗗埆鐨"{attribute}"鍗犱綅绗﹀锛堝弬瑙CValidator锛夛紝 CExistValidator杩樺厑璁告寚瀹氫笅鍒楀崰浣嶇锛
褰撲娇鐢message灞炴у畾涔変簡涓涓嚜瀹氫箟閿欒鎻愮ず淇℃伅锛 姝や俊鎭彲浠ュ寘鍚檮鍔犵殑鍗犱綅绗︼紝鍗犱綅绗﹀彲浠ヨ瀹為檯鍐呭鏇挎崲銆 闄や簡鍙互琚墍鏈夐獙璇佸櫒璇嗗埆鐨"{attribute}"鍗犱綅绗﹀锛堝弬瑙CValidator锛夛紝 CExistValidator杩樺厑璁告寚瀹氫笅鍒楀崰浣嶇锛
- {value}: 浣跨敤灞炴у兼浛鎹€
鍏叡灞炴
灞炴 | 绫诲瀷 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|---|
allowEmpty | boolean | 鏄惁姝ゅ睘鎬у煎彲浠ヤ负null鎴杄mpty銆傞粯璁ゅ间负true锛 琛ㄧず褰撴灞炴т负绌烘椂灏嗛氳繃楠岃瘉銆 | CUniqueValidator |
attributeName | string | 鍦ㄥ叾涓绱㈡灞炴у兼槸鍚﹀瓨鍦ㄧ殑 娲诲姩璁板綍绫荤殑灞炴х殑鍚嶅瓧銆傞粯璁ゅ间负null锛 琛ㄧず浣跨敤琚獙璇佺殑灞炴х殑鍚嶅瓧銆 | CUniqueValidator |
attributes | array | 闇瑕佽楠岃瘉鐨勫睘鎬х殑鍒楄〃銆 | CValidator |
builtInValidators | array | 鍐呯疆楠岃瘉鍣ㄥ垪琛 (name=>class) | CValidator |
caseSensitive | boolean | 姣旇緝鏃舵槸鍚﹀澶у皬鍐欐晱鎰熴傞粯璁ゅ兼槸true銆 娉ㄦ剰锛氬鏋滄鍊艰缃负false锛岃〃绀轰綘璁惧畾浜嗗睘鎬х殑绫诲瀷鏄瓧绗︿覆銆 | CUniqueValidator |
className | string | 鍦ㄥ叾涓绱㈡灞炴у兼槸鍚﹀瓨鍦ㄧ殑 娲诲姩璁板綍绫荤殑鍚嶅瓧銆傞粯璁ゅ间负null锛 琛ㄧず浣跨敤琚獙璇佺殑灞炴ф墍灞炵殑娲诲姩璁板綍绫汇 浣犲彲浠ュ湪姝や娇鐢ㄨ矾寰勫埆鍚嶆寚瀹氫竴涓被銆 | CUniqueValidator |
criteria | array | 闄勫姞鐨勬煡璇㈡潯浠躲傚畠涓庣敤浜庢娴嬪搴旂殑琛 鍜屽垪鏄惁瀛樺湪灞炴у肩殑鏉′欢缁勫悎鎴愪负鏈缁堢殑鏌ヨ鏉′欢銆 姝ゆ暟缁勭敤浜庡疄渚嬪寲涓涓CDbCriteria瀵硅薄銆 | CUniqueValidator |
enableClientValidation | boolean | 鏄惁鎵ц瀹㈡埛绔獙璇併傞粯璁ゅ间负true銆 鍙傝CActiveForm::enableClientValidation浠ヤ簡瑙f洿澶氬叧浜庡鎴风楠岃瘉鐨勭粏鑺傘 | CValidator |
message | string | 鐢ㄦ埛鑷畾涔夌殑閿欒鎻愮ず淇℃伅銆傚崰浣嶇"{attribute}" 鍜 "{value}" 鍙互琚瘑鍒紝瀹冧滑鍒嗗埆琚疄闄呯殑灞炴у悕瀛楀拰鍊兼浛鎹€ | CUniqueValidator |
on | array | 楠岃瘉鍣ㄥ皢琚簲鐢ㄥ埌鐨勬儏鏅ā寮忕殑鍒楄〃銆 鏁扮粍鐨勯敭-鍊奸兘鏄儏鏅ā寮忕殑鍚嶇О銆 | CValidator |
safe | boolean | 杩涜鏁村潡璧嬪兼槸鏄惁鑰冭檻姝ら獙璇佸櫒涓垪鍑虹殑灞炴х殑瀹夊叏鎬с 榛樿鍊间负true銆 | CValidator |
skipOnError | boolean | 濡傛灉褰撳墠灞炴у凡缁忓瓨鍦ㄩ獙璇侀敊璇椂锛屾槸鍚﹁烦杩 杩欐潯楠岃瘉瑙勫垯銆傞粯璁ゅ兼槸true銆 | CUniqueValidator |
鍏叡鏂规硶
鍙椾繚鎶ゆ柟娉
鏂规硶 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|
addError() | 娣诲姞鍏充簬鎸囧畾灞炴х殑涓涓敊璇彁绀轰俊鎭埌娲诲姩璁板綍涓 | CValidator |
isEmpty() | 妫娴嬬粰瀹氬兼槸鍚︿负绌恒 | CValidator |
validateAttribute() | 楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с | CUniqueValidator |
灞炴ц缁
allowEmpty
灞炴
public boolean $allowEmpty;
鏄惁姝ゅ睘鎬у煎彲浠ヤ负null鎴杄mpty銆傞粯璁ゅ间负true锛 琛ㄧず褰撴灞炴т负绌烘椂灏嗛氳繃楠岃瘉銆
attributeName
灞炴
public string $attributeName;
鍦ㄥ叾涓绱㈡灞炴у兼槸鍚﹀瓨鍦ㄧ殑 娲诲姩璁板綍绫荤殑灞炴х殑鍚嶅瓧銆傞粯璁ゅ间负null锛 琛ㄧず浣跨敤琚獙璇佺殑灞炴х殑鍚嶅瓧銆
鍙傝
caseSensitive
灞炴
public boolean $caseSensitive;
姣旇緝鏃舵槸鍚﹀澶у皬鍐欐晱鎰熴傞粯璁ゅ兼槸true銆 娉ㄦ剰锛氬鏋滄鍊艰缃负false锛岃〃绀轰綘璁惧畾浜嗗睘鎬х殑绫诲瀷鏄瓧绗︿覆銆
className
灞炴
public string $className;
鍦ㄥ叾涓绱㈡灞炴у兼槸鍚﹀瓨鍦ㄧ殑 娲诲姩璁板綍绫荤殑鍚嶅瓧銆傞粯璁ゅ间负null锛 琛ㄧず浣跨敤琚獙璇佺殑灞炴ф墍灞炵殑娲诲姩璁板綍绫汇 浣犲彲浠ュ湪姝や娇鐢ㄨ矾寰勫埆鍚嶆寚瀹氫竴涓被銆
鍙傝
criteria
灞炴
public array $criteria;
闄勫姞鐨勬煡璇㈡潯浠躲傚畠涓庣敤浜庢娴嬪搴旂殑琛 鍜屽垪鏄惁瀛樺湪灞炴у肩殑鏉′欢缁勫悎鎴愪负鏈缁堢殑鏌ヨ鏉′欢銆 姝ゆ暟缁勭敤浜庡疄渚嬪寲涓涓CDbCriteria瀵硅薄銆
message
灞炴
public string $message;
鐢ㄦ埛鑷畾涔夌殑閿欒鎻愮ず淇℃伅銆傚崰浣嶇"{attribute}" 鍜 "{value}" 鍙互琚瘑鍒紝瀹冧滑鍒嗗埆琚疄闄呯殑灞炴у悕瀛楀拰鍊兼浛鎹€
skipOnError
灞炴
锛堝彲鐢ㄨ嚜 v1.1.1锛
public boolean $skipOnError;
濡傛灉褰撳墠灞炴у凡缁忓瓨鍦ㄩ獙璇侀敊璇椂锛屾槸鍚﹁烦杩 杩欐潯楠岃瘉瑙勫垯銆傞粯璁ゅ兼槸true銆
鏂规硶璇︾粏
validateAttribute()
鏂规硶
protected void validateAttribute(CModel $object, string $attribute)
| ||
$object | CModel | 闇瑕侀獙璇佺殑瀵硅薄 |
$attribute | string | 闇瑕侀獙璇佺殑灞炴 |
婧愮爜锛 framework/validators/CUniqueValidator.php#79 (鏄剧ず)
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)));
$columnName=$column->rawName;
$criteria=new CDbCriteria(array(
'condition'=>$this->caseSensitive ? "$columnName=:value" : "LOWER($columnName)=LOWER(:value)",
'params'=>array(':value'=>$value),
));
if($this->criteria!==array())
$criteria->mergeWith($this->criteria);
if(!$object instanceof CActiveRecord || $object->isNewRecord || $object->tableName()!==$finder->tableName())
$exists=$finder->exists($criteria);
else
{
$criteria->limit=2;
$objects=$finder->findAll($criteria);
$n=count($objects);
if($n===1)
{
if($column->isPrimaryKey) // primary key is modified and not unique
$exists=$object->getOldPrimaryKey()!=$object->getPrimaryKey();
else
{
// non-primary key, need to exclude the current record based on PK
$exists=array_shift($objects)->getPrimaryKey()!=$object->getOldPrimaryKey();
}
}
else
$exists=$n>1;
}
if($exists)
{
$message=$this->message!==null?$this->message:Yii::t('yii','{attribute} "{value}" has already been taken.');
$this->addError($object,$attribute,$message,array('{value}'=>CHtml::encode($value)));
}
}
楠岃瘉浼犲叆瀵硅薄鐨勫睘鎬с 濡傛灉瀛樺湪浠讳綍楠岃瘉閿欒锛屾閿欒鐨勬彁绀轰俊鎭皢琚坊鍔犲埌姝ゅ璞′腑銆