CBooleanValidator

Подробности свойств

allowEmpty свойство

public boolean $allowEmpty;

указывает, может ли значение атрибута быть null или пустым. По умолчанию значение true, означающее, что если атрибут пустой, он считается допустимым.

falseValue свойство

public mixed $falseValue;

значение, представляющее ложное значение. По умолчанию '0'.

strict свойство

public boolean $strict;

указывает, является ли сравнение с trueValue и falseValue строгим. Если значение true, то значение и тип атрибута должны совпадать со значениями trueValue или falseValue. По умолчанию false, что означает, что нужно только сопоставить значение.

trueValue свойство

public mixed $trueValue;

значение, представляющее истинное значение. По умолчанию '1'.

Подробное описание методов

clientValidateAttribute() метод (доступен с версии v1.1.7)

public string clientValidateAttribute(CModel $object, string $attribute)

public function clientValidateAttribute($object,$attribute)
{
    $message=$this->message!==null ? $this->message : Yii::t('yii','{attribute} must be either {true} or {false}.');
    $message=strtr($message, array(
        '{attribute}'=>$object->getAttributeLabel($attribute),
        '{true}'=>$this->trueValue,
        '{false}'=>$this->falseValue,
    ));
    return "
if(".($this->allowEmpty ? "jQuery.trim(value)!='' && " : '')."value!=".CJSON::encode($this->trueValue)." && value!=".CJSON::encode($this->falseValue).") {
messages.push(".CJSON::encode($message).");
}
";
}

Возвращает JavaScript, необходимый для выполнения проверки на стороне клиента.

validateAttribute() метод

protected void validateAttribute(CModel $object, string $attribute)

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} must be either {true} or {false}.');
        $this->addError($object,$attribute,$message,array(
            '{true}'=>$this->trueValue,
            '{false}'=>$this->falseValue,
        ));
    }
}

Проверяет атрибут объекта. Если обнаружена ошибка, сообщение об ошибке добавляется к объекту.

validateValue() метод (доступен с версии v1.1.17)

public boolean validateValue(mixed $value)

public function validateValue($value)
{
    if ($this->strict)
        return $value===$this->trueValue || $value===$this->falseValue;
    else
        return $value==$this->trueValue || $value==$this->falseValue;
}

Проверяет статическое значение на предмет того, является ли оно допустимым boolean. Этот метод предоставлен для того, чтобы вы могли вызывать его напрямую, не проходя через механизм правила валидации модели.

Обратите внимание, что этот метод не учитывает свойство allowEmpty.