CTypeValidator

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

allowEmpty свойство

public boolean $allowEmpty;

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

dateFormat свойство

public string $dateFormat;

шаблон формата, которому должно соответствовать значение даты. По умолчанию 'MM/dd/yyyy'. Подробности о том, как указать формат даты, см. в CDateTimeParser. Это свойство эффективно только тогда, когда тип равен 'date'.

datetimeFormat свойство

public string $datetimeFormat;

шаблон формата, которому должно соответствовать значение даты и времени. По умолчанию 'MM/dd/yyyy hh:mm'. Подробности о том, как указать формат даты и времени, см. в CDateTimeParser. Это свойство эффективно только тогда, когда тип равен 'datetime'.

strict свойство (доступно начиная с версии v1.1.13)

public boolean $strict;

указывает, следует ли проверять фактический PHP-тип значения атрибута. По умолчанию false, что означает, что правильно отформатированные строки принимаются для валидаторов целых чисел и чисел с плавающей точкой.

timeFormat свойство

public string $timeFormat;

шаблон формата, которому должно соответствовать значение времени. По умолчанию 'hh:mm'. Подробности о том, как указать формат времени, см. в CDateTimeParser. Это свойство эффективно только тогда, когда тип равен 'time'.

type свойство

public string $type;

тип данных, которому должен соответствовать атрибут. По умолчанию 'string'. Допустимые значения включают 'string', 'integer', 'float', 'array', 'date', 'time' и 'datetime'.

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

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 {type}.');
        $this->addError($object,$attribute,$message,array('{type}'=>$this->type));
    }
}

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

validateValue() метод (доступно начиная с v1.1.13)

public boolean validateValue(mixed $value)

public function validateValue($value)
{
    $type=$this->type==='float' ? 'double' : $this->type;
    if($type===gettype($value))
        return true;
    elseif($this->strict || is_array($value) || is_object($value) || is_resource($value) || is_bool($value))
        return false;

    if($type==='integer')
        return (boolean)preg_match('/^[-+]?[0-9]+$/',trim($value));
    elseif($type==='double')
        return (boolean)preg_match('/^[-+]?([0-9]*\.)?[0-9]+([eE][-+]?[0-9]+)?$/',trim($value));
    elseif($type==='date')
        return CDateTimeParser::parse($value,$this->dateFormat,array('month'=>1,'day'=>1,'hour'=>0,'minute'=>0,'second'=>0))!==false;
    elseif($type==='time')
        return CDateTimeParser::parse($value,$this->timeFormat)!==false;
    elseif($type==='datetime')
        return CDateTimeParser::parse($value,$this->datetimeFormat, array('month'=>1,'day'=>1,'hour'=>0,'minute'=>0,'second'=>0))!==false;

    return false;
}

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