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', ...
    ]
    
    对于每条规则,您至少应该定义该规则适用于哪些属性以及应用的规则类型。
    核心验证规则是 - boolean,captcha,compare,date,default,double,each,email,exist,file,filter,image,ip,in,integer,match,number,required,safe,string,trim,unique,网址。
    第 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'],
             ];
          }
       }
    ?>
    
    我们已经声明了注册表的模型。该模型有五个属性——用户名、密码、电子邮件、国家、城市和电话。它们都是必需的,并且 email 属性必须是有效的电子邮件地址。
    第 3 步- 将actionRegistration方法添加到我们创建新的RegistrationForm模型并将其传递给视图的SiteController 。
    
    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 步- 要自定义用户名属性的错误消息,请按以下方式修改RegistrationForm的rules()方法。
    
    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并单击提交按钮。您会注意到用户名属性的错误消息已更改。
    更改用户名属性
    第 8 步 - 要自定义验证过程,您可以覆盖这些方法。
    • yii\base\Model::beforeValidate(): 触发一个
      yii\base\Model::EVENT_BEFORE_VALIDATE 事件。
    • yii\base\Model::afterValidate(): 触发一个
      yii\base\Model::EVENT_AFTER_VALIDATE 事件。
    第 9 步- 要修剪 country 属性周围的空格并将 city 属性的空输入变为 null,您可以使用trimdefault验证器。
    
    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”值。