CDefaultValueValidator
| Пакет | system.validators |
|---|---|
| Наследование | class CDefaultValueValidator » CValidator » CComponent |
| Исходный код | framework/validators/CDefaultValueValidator.php |
CDefaultValueValidator устанавливает атрибуты со значением, указанным в нём. Он не выполняет валидацию, а скорее позволяет установить значение по умолчанию одновременно с выполнением проверки. Обычно это происходит при вызове
$model->validate() или $model->save(). Общественные свойства
| Свойство | Тип | Описание | Определено в |
|---|---|---|---|
| attributes | массив | список атрибутов, которые нужно проверить. | CValidator |
| builtInValidators | массив | список встроенных валидаторов (имя=>класс) | CValidator |
| enableClientValidation | логическое | выполнять ли проверку на стороне клиента. | CValidator |
| except | массив | список сценариев, для которых валидатор не должен применяться. | CValidator |
| message | строка | пользовательское сообщение об ошибке. | CValidator |
| on | массив | список сценариев, для которых должен применяться валидатор. | CValidator |
| safe | логическое | являются ли атрибуты, указанные с этим валидатором, безопасными для массового присваивания. | CValidator |
| setOnEmpty | логическое | устанавливать ли значение по умолчанию только тогда, когда значение атрибута равно null или пустой строке. | CDefaultValueValidator |
| skipOnError | логическое | пропускать ли данное правило проверки, когда уже есть ошибка проверки для текущего атрибута. | CValidator |
| value | смешанный | значение по умолчанию, которое нужно установить для указанных атрибутов. | CDefaultValueValidator |
Общественные методы
| Метод | Описание | Определено в |
|---|---|---|
| __call() | Вызывает метод с заданным именем, который не является методом класса. | CComponent |
| __get() | Возвращает значение свойства, список обработчиков событий или поведение на основе его имени. | CComponent |
| __isset() | Проверяет, является ли значение свойства null. | CComponent |
| __set() | Устанавливает значение свойства компонента. | CComponent |
| __unset() | Устанавливает свойство компонента в null. | CComponent |
| applyTo() | Возвращает значение, указывающее, применим ли валидатор к указанному сценарию. | CValidator |
| asa() | Возвращает объект поведения с заданным именем. | CComponent |
| attachBehavior() | Присоединяет поведение к данному компоненту. | CComponent |
| attachBehaviors() | Присоединяет список поведений к компоненту. | CComponent |
| attachEventHandler() | Присоединяет обработчик событий к событию. | CComponent |
| canGetProperty() | Определяет, можно ли прочитать свойство. | CComponent |
| canSetProperty() | Определяет, можно ли установить свойство. | CComponent |
| clientValidateAttribute() | Возвращает JavaScript, необходимый для выполнения проверки на стороне клиента. | CValidator |
| createValidator() | Создает объект валидатора. | CValidator |
| detachBehavior() | Отсоединяет поведение от компонента. | CComponent |
| detachBehaviors() | Отсоединяет все поведения от компонента. | CComponent |
| detachEventHandler() | Отсоединяет существующий обработчик событий. | CComponent |
| disableBehavior() | Отключает присоединенное поведение. | CComponent |
| disableBehaviors() | Отключает все присоединённые поведения компонента. | CComponent |
| enableBehavior() | Включает присоединённое поведение. | CComponent |
| enableBehaviors() | Включает все присоединённые поведения компонента. | CComponent |
| evaluateExpression() | Вычисляет PHP выражение или обратный вызов в контексте этого компонента. | CComponent |
| getEventHandlers() | Возвращает список присоединённых обработчиков событий для события. | CComponent |
| hasEvent() | Определяет, определено ли событие. | CComponent |
| hasEventHandler() | Проверяет, имеет ли событие с заданным именем присоединенные обработчики. | CComponent |
| hasProperty() | Определяет, определено ли свойство. | CComponent |
| raiseEvent() | Вызывает событие. | CComponent |
| validate() | Проверяет указанный объект. | CValidator |
Защищённые методы
| Метод | Описание | Определено в |
|---|---|---|
| addError() | Добавляет ошибку об указанном атрибуте в активную запись. | CValidator |
| isEmpty() | Проверяет, является ли заданное значение пустым. | CValidator |
| validateAttribute() | Проверяет атрибут объекта. | CDefaultValueValidator |
Подробности свойств
setOnEmpty свойство
public boolean $setOnEmpty;
устанавливать ли значение по умолчанию только при null или пустой строке значения атрибута. По умолчанию true. Если false, атрибут всегда будет назначен значением по умолчанию, даже если ему уже явно присвоено значение.
значение свойство
public mixed $value;
значение по умолчанию, которое должно быть установлено для указанных атрибутов.
Подробное описание методов
validateAttribute() метод
protected void validateAttribute(CModel $object, string $attribute) | ||
| $object | CModel | валидируемый объект |
| $attribute | строка | валидируемый атрибут |
Исходный код: framework/validators/CDefaultValueValidator.php#38 (показать)
protected function validateAttribute($object,$attribute)
{
if(!$this->setOnEmpty)
$object->$attribute=$this->value;
else
{
$value=$object->$attribute;
if($value===null || $value==='')
$object->$attribute=$this->value;
}
}
Проверяет атрибут объекта.
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc/api/1.1/CDefaultValueValidator
