Учебники

Yii – Валидация

Вы никогда не должны доверять данным, полученным от пользователей. Чтобы проверить модель с пользовательскими данными, вы должны вызвать метод yii \ base \ Model :: validate () . Возвращает логическое значение, если проверка прошла успешно. Если есть ошибки, вы можете получить их из свойства yii \ base \ Model :: $ errors .

Использование правил

Чтобы заставить функцию validate () работать, вы должны переопределить метод yii \ base \ Model :: rules () .

Шаг 1 – Метод rules () возвращает массив в следующем формате.

[
   // required, specifies which attributes should be validated
   ['attr1', 'attr2', ...],
   // required, specifies the type a rule.
   'type_of_rule',
   // optional, defines in which scenario(s) this rule should be applied
   'on' => ['scenario1', 'scenario2', ...],
   // optional, defines additional configurations
   'property' => 'value', ...
]

Для каждого правила вы должны определить, по крайней мере, к каким атрибутам применяется правило и тип применяемого правила.

Основные правила проверки: логическое, капча, сравнение, дата, по умолчанию, дважды, каждый, электронная почта, существует, файл, фильтр, изображение, ip, in, целое число, совпадение, число, требуется, безопасный, строка, обрезка, уникальный, URLадрес.

Шаг 2 – Создайте новую модель в папке моделей .

<?php
   namespace app\models;
   use Yii;
   use yii\base\Model;
   class RegistrationForm extends Model {
      public $username;
      public $password;
      public $email;
      public $country;
      public $city;
      public $phone;
      public function rules() {
         return [
            // the username, password, email, country, city, and phone attributes are
            //required
            [['username' ,'password', 'email', 'country', 'city', 'phone'], 'required'],
            // the email attribute should be a valid email address
            ['email', 'email'],
         ];
      }
   }
?>

Мы объявили модель для регистрационной формы. Модель имеет пять свойств – имя пользователя, пароль, адрес электронной почты, страна, город и телефон. Все они обязательны, а адрес электронной почты должен быть действительным адресом электронной почты.

Шаг 3 – Добавьте метод actionRegistration в SiteController, где мы создадим новую модель RegistrationForm и передадим ее в представление.

public function actionRegistration() {
   $model = new RegistrationForm();
   return $this->render('registration', ['model' => $model]);
}

Шаг 4 – Добавьте представление для нашей регистрационной формы. Внутри папки views / site создайте файл registration.php со следующим кодом.

<?php
   use yii\bootstrap\ActiveForm;
   use yii\bootstrap\Html;
?>

<div class = "row">
   <div class = "col-lg-5">
      <?php $form = ActiveForm::begin(['id' => 'registration-form']); ?>
         <?= $form->field($model, 'username') ?>
         <?= $form->field($model, 'password')->passwordInput() ?>
         <?= $form->field($model, 'email')->input('email') ?>
         <?= $form->field($model, 'country') ?>
         <?= $form->field($model, 'city') ?>
         <?= $form->field($model, 'phone') ?>
         <div class = "form-group">
            <?= Html::submitButton('Submit', ['class' => 'btn btn-primary',
               'name' => 'registration-button']) ?>
         </div>
      <?php ActiveForm::end(); ?>
   </div>
</div>

Мы используем виджет ActiveForm для отображения нашей регистрационной формы.

Шаг 5 – Если вы зайдете на локальный хост http: // localhost: 8080 / index.php? R = site / registration и нажмете кнопку отправки, вы увидите правила проверки в действии.

Правила валидации

Шаг 6. Чтобы настроить сообщение об ошибке для свойства username , измените метод rules () объекта RegistrationForm следующим образом.

public function rules() {
   return [
      // the username, password, email, country, city, and phone attributes are required
      [['password', 'email', 'country', 'city', 'phone'], 'required'],
      ['username', 'required', 'message' => 'Username is required'],
      // the email attribute should be a valid email address
      ['email', 'email'],
   ];
}

Шаг 7. Перейдите на локальный хост http: // localhost: 8080 / index.php? R = site / registration и нажмите кнопку отправки. Вы заметите, что сообщение об ошибке свойства username изменилось.

Изменить имя пользователя

Шаг 8 – Чтобы настроить процесс проверки, вы можете переопределить эти методы.

  • yii \ base \ Model :: beforeValidate (): запускает

    событие yii \ base \ Model :: EVENT_BEFORE_VALIDATE.

  • yii \ base \ Model :: afterValidate (): запускает

    событие yii \ base \ Model :: EVENT_AFTER_VALIDATE.

yii \ base \ Model :: beforeValidate (): запускает

событие yii \ base \ Model :: EVENT_BEFORE_VALIDATE.

yii \ base \ Model :: afterValidate (): запускает

событие yii \ base \ Model :: EVENT_AFTER_VALIDATE.

Шаг 9 – Чтобы обрезать пробелы вокруг свойства страны и превратить пустой ввод свойства города в ноль, вы можете обрезать и валидаторы по умолчанию .

public function rules() {
   return [
      // the username, password, email, country, city, and phone attributes are required
      [['password', 'email', 'country', 'city', 'phone'], 'required'],
      ['username', 'required', 'message' => 'Username is required'],
      ['country', 'trim'],
      ['city', 'default'],
      // the email attribute should be a valid email address
      ['email', 'email'],
   ];
}

Шаг 10 – Если вход пуст, вы можете установить для него значение по умолчанию.

public function rules() {
   return [
      ['city', 'default', 'value' => 'Paris'],
   ];
}

Если свойство city пусто, будет использовано значение по умолчанию «Paris».