| 包 | system.validators |
|---|---|
| 继承 | class CUrlValidator » CValidator » CComponent |
| 源自 | 1.0 |
| 版本 | $Id: CUrlValidator.php 3242 2011-05-28 14:31:04Z qiang.xue $ |
| 源码 |
CUrlValidator验证属性值是一个有效的http或https地址。
公共属性
| 属性 | 类型 | 描述 | 定义在 |
|---|---|---|---|
| allowEmpty | boolean | 此属性值是否可以为null或empty。默认值是true， 表示如果此属性值为空时将通过验证。 | CUrlValidator |
| attributes | array | 需要被验证的属性的列表。 | CValidator |
| builtInValidators | array | 内置验证器列表 (name=>class) | CValidator |
| defaultScheme | string | 默认的URI方案（scheme）。如果用户的输入不包含方案部份， 默认方案将附于其上（从而改变用户的输入）。默认值是null，表示 一个URL必须包含方案部分。 | CUrlValidator |
| enableClientValidation | boolean | 是否执行客户端验证。默认值为true。 参见CActiveForm::enableClientValidation以了解更多关于客户端验证的细节。 | CValidator |
| message | string | 用户自定义的错误提示信息。不同的验证器可以在该信息中 定义各种占位符（将被实际值替换）。占位符“{attribute}”可以被所有 验证器识别，它会被使用属性的标签来替换。 | CValidator |
| on | array | 验证器将被应用到的情景模式的列表。 数组的键-值都是情景模式的名称。 | CValidator |
| pattern | string | 用于验证属性值的正则表达式。 从1. | CUrlValidator |
| safe | boolean | 进行整块赋值是是否考虑此验证器中列出的属性的安全性。 默认值为true。 | CValidator |
| skipOnError | boolean | 如果当前属性已经存在验证错误，这个验证规则 是否跳过。默认值是false。 | CValidator |
| validSchemes | array | 可以通过验证的URI方案的列表。默认情况下， 包括http和https。 | CUrlValidator |
公共方法
受保护方法
| 方法 | 描述 | 定义在 |
|---|---|---|
| addError() | 添加关于指定属性的一个错误提示信息到活动记录中。 | CValidator |
| isEmpty() | 检测给定值是否为空。 | CValidator |
| validateAttribute() | 验证传入对象的属性。 | CUrlValidator |
属性详细
allowEmpty
属性
public boolean $allowEmpty;
此属性值是否可以为null或empty。默认值是true， 表示如果此属性值为空时将通过验证。
defaultScheme
属性
（可用自 v1.1.7）
public string $defaultScheme;
默认的URI方案（scheme）。如果用户的输入不包含方案部份， 默认方案将附于其上（从而改变用户的输入）。默认值是null，表示 一个URL必须包含方案部分。
pattern
属性
public string $pattern;
用于验证属性值的正则表达式。 从1.1.7版开始，此模板可以包含一个{schemes}令牌，它将被一个 表示{@see validSchemes}的正则表达式替换。
validSchemes
属性
（可用自 v1.1.7）
public array $validSchemes;
可以通过验证的URI方案的列表。默认情况下， 包括http和https。
方法详细
clientValidateAttribute()
方法
（可用自 v1.1.7）
|
public string clientValidateAttribute(CModel $object, string $attribute)
| ||
| $object | CModel | 需要验证的对象 |
| $attribute | string | 需要验证的属性的名字 |
| {return} | string | 客户端验证脚本 |
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;
}
返回执行客户端验证所需的Javascript。
validateAttribute()
方法
|
protected void validateAttribute(CModel $object, string $attribute)
| ||
| $object | CModel | 需要验证的对象 |
| $attribute | string | 需要验证的属性 |
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则返回false，否则可能是修改过的值（{@see defaultScheme}）。 |
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属性的影响。 此方法的目的是使你可以简单地直接调用它而不用通过模型验证规则机制。