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,在,整数,匹配,数字,必需,安全,字符串,网址。
第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 =站点/注册 ,然后单击提交按钮,您将看到验证规则正在运行。
步骤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 =站点/注册 ,然后单击提交按钮。您会注意到,用户名属性的错误消息已更改。
第8步 - 要定制验证过程,您可以重写这些方法。
- yii \ base \ Model :: beforeValidate():触发一个
yii \ base \ Model :: EVENT_BEFORE_VALIDATE事件。
- yii \ base \ Model :: afterValidate():触发一个
yii \ base \ Model :: EVENT_AFTER_VALIDATE事件。
第9步 - 要修剪country属性周围的空间并将城市属性的空输入变为null,您可以使用 trim 和 default 验证器。
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'], ]; }
如果城市属性为空,则将使用默认的“巴黎”值。
下一章:Yii Ad Hoc验证
有时您需要验证未绑定到任何模型的值。您可以使用 yii \ base \ DynamicModel 类,它支持即时定义属性和规则。第1步 - 将 actionAdHocValidation 方法添加到 SiteCo ...