Yii - Validación

Nunca debe confiar en los datos recibidos de los usuarios. Para validar un modelo con entradas de usuario, debe llamaryii\base\Model::validate()método. Devuelve un valor booleano si la validación se realiza correctamente. Si hay errores, puede obtenerlos delyii\base\Model::$errors propiedad.

Usando reglas

Para hacer el validate() función funciona, debe anular la yii\base\Model::rules() método.

Step 1 - el rules() El método devuelve una matriz en el siguiente formato.

[
   // 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', ...
]

Para cada regla, debe definir al menos a qué atributos se aplica la regla y el tipo de regla que se aplica.

Las reglas básicas de validación son: boolean, captcha, compare, date, default, double, each, email, exist, file, filter, image, ip, in, integer, match, number, required, safe, string, trim, unique, url.

Step 2 - Crea un nuevo modelo en el models carpeta.

<?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'],
         ];
      }
   }
?>

Hemos declarado el modelo del formulario de registro. El modelo tiene cinco propiedades: nombre de usuario, contraseña, correo electrónico, país, ciudad y teléfono. Todos son obligatorios y la propiedad de correo electrónico debe ser una dirección de correo electrónico válida.

Step 3 - Agregue el actionRegistration método para el SiteController donde creamos un nuevo RegistrationForm modelar y pasarlo a una vista.

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

Step 4- Agregue una vista para nuestro formulario de registro. Dentro de la carpeta views / site, cree un archivo llamado registration.php con el siguiente código.

<?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>

Estamos usando el ActiveForm widget para mostrar nuestro formulario de registro.

Step 5 - Si vas al anfitrión local http://localhost:8080/index.php?r=site/registration y haga clic en el botón enviar, verá las reglas de validación en acción.

Step 6 - Para personalizar el mensaje de error para el username propiedad, modificar la rules() método del RegistrationForm de la siguiente manera.

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'],
   ];
}

Step 7 - Ir al anfitrión local http://localhost:8080/index.php?r=site/registrationy haga clic en el botón enviar. Notará que el mensaje de error de la propiedad del nombre de usuario ha cambiado.

Step 8 - Para personalizar el proceso de validación, puede anular estos métodos.

  • yii \ base \ Model :: beforeValidate (): activa un

    yii \ base \ Model :: EVENT_BEFORE_VALIDATE evento.

  • yii \ base \ Model :: afterValidate (): activa un

    yii \ base \ Model :: EVENT_AFTER_VALIDATE evento.

Step 9 - Para recortar los espacios alrededor de la propiedad de campo y convertir la entrada vacía de la propiedad de la ciudad en un valor nulo, puede trim y default validadores.

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'],
   ];
}

Step 10 - Si una entrada está vacía, puede establecer un valor predeterminado para ella.

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

Si la propiedad de la ciudad está vacía, se utilizará el valor predeterminado de "París".