Как правило, вы никогда не должны доверять данным, полученным от пользователей и всегда проверять их прежде, чем работать с ними и добавлять в базу данных.
Учитывая [модель](structure-models.md) данных которые должен заполнить пользователь, можно проверить эти данные на валидность воспользовавшись методом `[[yii\base\Model::validate()]]`. Метод возвращает логическое значение с результатом валидации ложь/истина. Если данные не валидны, ошибку можно получить воспользовавшись методом `[[yii\base\Model::errors]]`. Рассмотрим пример:
// данные не корректны: $errors - массив содержащий сообщения об ощибках
$errors=$model->errors;
}
```
## Правила проверки <a name="declaring-rules"></a>
Для того, чтобы `validate()` действительно работал, нужно объявить правила проверки атрибутов.
Правила для проверки нужно указать в методе `[[yii\base\Model::rules()]]`. В следующем примере показано, как
правила для проверки модели `ContactForm`, нужно объявлять:
```php
publicfunctionrules()
{
return[
// атрибут required указывает, что name, email, subject, body обязательны для заполнения
[['name','email','subject','body'],'required'],
// атрибут email указывает, что в переменной email должен быть корректный адрес электронной почты
['email','email'],
];
}
```
Метод должен `[[yii\base\Model::rules()|rules()]]` возвращать массив правил, каждое из которых является массивом в следующем формате:
```php
[
// обязательный, указывает, какие атрибуты должны быть проверены по этому правилу.
// Для одного атрибута, вы можете использовать имя атрибута не создавая массив
['attribute1','attribute2',...],
// обязательный, указывает тип правила.
// Это может быть имя класса, псевдоним валидатора, или метод для проверки
'validator',
// необязательный, указывает, в каком случае(ях) это правило должно применяться
// если не указан, это означает, что правило применяется ко всем сценариям
// Вы также можете настроить "except" этот вариан применяет правило ко всем
// сценариям кроме перечисленных
'on'=>['scenario1','scenario2',...],
// необязательный, задает дополнительные конфигурации для объекта validator
'property1'=>'value1','property2'=>'value2',...
]
```
Для каждого правила необходимо указать, по крайней мере, какие атрибуты относится к этому правило и тип правила.
Вы можете указать тип правила в одном из следующих форматов:
* Псевдонимы основного валидатора, например `required`, `in`, `date` и другие. Пожалуйста, обратитесь к списку
[Основных валидаторов](tutorial-core-validators.md) за более подробной информацией.
* Название метода проверки в моделе класса, или анонимную функцию. Пожалуйста, обратитесь к разделу
[Встроенных валидаторов](#inline-validators) за более подробной информацией.
* Полное имя класса валидатора. Пожалуйста, обратитесь к разделу [Автономных валидаторов](#standalone-validators)
за более подробной информацией.
Правило может использоваться для проверки одного или нескольких атрибутов. Атрибут может быть проверен одним или несколькими правилами.
Правило может быть применено только к определенным [сценариям](structure-models.md#scenarios) указав свойство `on`.
Если вы не укажите свойство `on`, это означает, что правило будет применяться ко всем сценариям.
Когда вызывается метод `validate()` для проверки, он выполняет следующие действия:
1. Определяет, какие атрибуты должны проверяться путем получения списка атрибутов от `[[yii\base\Model::scenarios()]]`
используя текущий `[[yii\base\Model::scenario|scenario]]`. Эти атрибуты называются - *активными атрибутами*.
2. Определяет, какие правила проверки должны использоваться, получив список правил от `[[yii\base\Model::rules()]]`
используя текущий `[[yii\base\Model::scenario|scenario]]`. Эти правила называются - *активными правилами*.
3. Каждое активное правило проверяет каждый активный атрибут, который ассоциируется с правилом.
Правила проверки выполняются в том порядке, как они перечислены.
Согластно вышеизложеным пунктам, атрибут будет проверяться, если и только если он является
активным атрибутом, объявленных в `scenarios()` и связан с одним или несколькими активными правилами,
объявленными в `rules()`.
### Настройка сообщений об ошибках <a name="customizing-error-messages"></a>
Большинство валидаторов имеют сообщения об ошибках по умолчанию, которые будут добавлены к модели когда его атрибуты не проходят проверку.
Например, `[[yii\validators\RequiredValidator|required]]` валидатор добавил к модели сообщение об ошибке "Имя пользователя не может быть пустым." когда атрибут `username` не удовлетворил правила этого валидатора.
Вы можете настроить сообщение об ошибке для каждого правила, указав свойство `message` при объявлении правила, следующим образом:
```php
publicfunctionrules()
{
return[
['username','required','message'=>'Please choose a username.'],
];
}
```
Некоторые валидаторы могут поддерживать дополнительные сообщения об ошибках, чтобы более точно описать причину ошибки.
Например, `[[yii\validators\NumberValidator|number]]` валидатор поддерживает
`[[yii\validators\NumberValidator::tooBig|tooBig]]` и `[[yii\validators\NumberValidator::tooSmall|tooSmall]]`
для описания ошибки валидации, когда проверяемое значение является слишком большим и слишком маленьким, соответственно.
Вы можете настроить эти сообщения об ошибках, как в настройках валидаторов, так и непосредственно в правилах проверки.
### События валидации <a name="validation-events"></a>
Когда вызывается метод `[[yii\base\Model::validate()]]` он инициализирует вызов двух методов,
которые можно переопределить, чтобы настроить процесс проверки:
*`[[yii\base\Model::beforeValidate()]]`: выполнение по умолчанию вызовет `[[yii\base\Model::EVENT_BEFORE_VALIDATE]]`
событие. Вы можете переопределить этот метод, или обрабатывать это событие, чтобы сделать некоторую предобработку данных (например, форматирование входных данных), метод вызывается до начала валидации. Этот метод должен возвращать логическое значение, указывающее, следует ли продолжать проверку или нет.
*`[[yii\base\Model::afterValidate()]]`: выполнение по умолчанию вызовет `[[yii\base\Model::EVENT_AFTER_VALIDATE]]`
событие. Вы можете либо переопределить этот метод или обрабатывать это событие, чтобы сделать некоторую постобработку данных(Например, отформатировать данные удобным для дальнейшей обработки образом), метод вызывается после валидации.
Для проверки атрибутов только при выполнении определенных условий, например если один атрибут зависит от значения другого атрибута можно использовать `[[yii\validators\Validator::when|when]]` свойство, чтобы определить такие условия. Например:
```php
[
['state','required','when'=>function($model){
return$model->country=='USA';
}],
]
```
Это свойство `[[yii\validators\Validator::when|when]]` принимает PHP callable функциию с следующим описанием:
```php
/**
* @param Model $model модель используемая для проверки
* @param string $attribute атрибут для проверки
* @return boolean следует ли применять правило
*/
function($model,$attribute)
```
Если вам нужна поддержка условной проверки на стороне клиента, вы должны настроить свойство метода
`[[yii\validators\Validator::whenClient|whenClient]]` которое принимает строку, представляющую JavaScript
функцию, возвращаемое значение определяет, следует ли применять правило или нет. Например:
```php
[
['state','required','when'=>function($model){
return$model->country=='USA';
},'whenClient'=>"function (attribute, value) {
return $('#country').val() == 'USA';
}"],
]
```
### Фильтрация данных <a name="data-filtering"></a>
Пользователь частво вводит данные которые нужно предварительно отфильтровать или предварительно обработать(очистить).
Например, вы хотите обрезать пробелы вокруг `username`. Вы можете использовать правила валидации для
достижения этой цели.
В следующих примерах показано, как обрезать пробелы в входных данных и превратить пустые входные данные в NULL
с помощью [trim](tutorial-core-validators.md#trim) и указать значения по умолчанию с помощью свойства
[default](tutorial-core-validators.md#default) основного валидатора:
```php
[
[['username','email'],'trim'],
[['username','email'],'default'],
]
```
Вы также можете использовать более сложные фильтрации данных с помощью анонимной функции
подробнее об этом [filter](tutorial-core-validators.md#filter).
Как видите, эти правила валидации на самом деле не проверяют входные данные. Вместо этого,
они будут обрабатывать значения и обратно возвращать результат работы. Фильтры по сути выполняют предобработку входящих данных.
### Обработка пустых входных данных <a name="handling-empty-inputs"></a>
Если входные данные представлены из HTML-формы, часто нужно присвоить некоторые значения
по умолчанию для входных данных, если они не заполнены. Вы можете сделать это с помощью
> Примечание: метод `resolve()` должен быть вызван после того, как атрибут был проверен.
В противном случае основная проверки формы не будет завершена.
Для простоты работы с массивом `deferred`, существует упрощенный метод `add()`, который автоматически создает Отложенный объект и добавляет его в `deferred` массив. Используя этот метод, вы можете упростить пример выше, следующим образом:
