9.5 项目实现迭代十二：完成“添加文章”页面中的模型验证

在Web开发中，数据验证是确保用户输入数据质量和安全性的关键环节。Yii2框架以其强大的模型验证机制，为开发者提供了灵活且易于实现的数据验证方案。在本章节中，我们将详细探讨如何在Yii2项目中为“添加文章”页面实现模型验证，确保用户提交的文章数据符合预设的规则，如标题非空、内容长度适中、发布时间有效等。

9.5.1 理解模型验证的重要性

在Web应用中，用户输入的数据往往是不可控的，可能包含非法字符、空值或不符合业务逻辑的数据。如果不进行验证直接存储到数据库，可能会导致数据污染、程序异常甚至安全漏洞。因此，在数据入库之前进行严格的验证是必不可少的步骤。Yii2的模型验证机制允许开发者在模型中定义验证规则，这些规则会在数据保存前自动执行，从而确保数据的合法性和准确性。

9.5.2 创建或准备文章模型

首先，确保你有一个用于表示文章数据的模型类。通常，这个类会继承自Yii2的\yii\db\ActiveRecord类，并映射到数据库中的相应表。假设我们的文章模型名为Article，并且已经通过Gii工具生成或手动创建好了。

namespace app\models;
use Yii;
use yii\db\ActiveRecord;
class Article extends ActiveRecord
{
    // 定义表名
    public static function tableName()
    {
        return '{{%article}}';
    }
    // 后续将在这里添加验证规则
}

9.5.3 定义验证规则

在Article模型中，我们需要定义一系列的验证规则。Yii2提供了丰富的验证器（Validators），如RequiredValidator（必填验证）、StringValidator（字符串验证，包括长度验证）、DateValidator（日期验证）等，可以直接在模型中通过rules()方法定义。

public function rules()
{
    return [
        [['title', 'content'], 'required', 'message' => '此项不能为空。'],
        ['title', 'string', 'min' => 3, 'max' => 255, 'tooShort' => '标题至少3个字符。', 'tooLong' => '标题不能超过255个字符。'],
        ['content', 'string', 'min' => 10, 'max' => 5000, 'tooShort' => '内容至少10个字符。', 'tooLong' => '内容不能超过5000个字符。'],
        ['publish_time', 'date', 'format' => 'php:Y-m-d H:i:s', 'message' => '发布时间格式不正确。'],
        // 可以继续添加其他验证规则
    ];
}

在上述代码中，我们为title（标题）、content（内容）和publish_time（发布时间）字段分别定义了验证规则。required验证器确保字段不为空；string验证器用于检查字符串的长度；date验证器则确保日期格式正确。

9.5.4 在控制器中使用模型验证

在控制器中处理表单提交时，我们需要利用模型的验证功能来检查用户输入的数据是否合法。Yii2的ActiveForm组件和模型验证机制紧密集成，使得这一过程变得非常简单。

public function actionCreate()
{
    $model = new Article();
    if ($model->load(Yii::$app->request->post()) && $model->save()) {
        // 数据验证通过且保存成功
        return $this->redirect(['view', 'id' => $model->id]);
    } else {
        // 数据验证失败或未提交数据
        return $this->render('create', [
            'model' => $model,
        ]);
    }
}

在上述actionCreate方法中，我们首先创建了一个Article模型的实例。然后，使用load()方法尝试将POST请求中的数据填充到模型中。如果数据成功加载，$model->save()将尝试保存数据到数据库，并在此过程中自动触发模型验证。如果验证失败或数据未通过POST提交，则渲染create视图，并将模型实例传递给视图，以便在表单中显示验证错误信息。

9.5.5 在视图中显示验证错误信息

在create视图中，我们需要使用Yii2的表单助手（如ActiveForm）来构建表单，并显示模型验证的错误信息。Yii2的ActiveForm会自动捕获模型验证的错误，并允许我们通过$form->error()或$model->getFirstError('attributeName')等方法在视图中显示这些错误。

<?php $form = ActiveForm::begin(); ?>
<?= $form->field($model, 'title')->textInput(['maxlength' => true]) ?>
<?= $form->error($model, 'title') ?>
<?= $form->field($model, 'content')->textarea(['rows' => 6]) ?>
<?= $form->error($model, 'content') ?>
<?= $form->field($model, 'publish_time')->widget(DatePicker::class, [
    'options' => ['class' => 'form-control'],
    'dateFormat' => 'php:Y-m-d H:i:s',
]) ?>
<?= $form->error($model, 'publish_time') ?>
<div class="form-group">
    <?= Html::submitButton('提交', ['class' => 'btn btn-primary']) ?>
</div>
<?php ActiveForm::end(); ?>

在上述视图中，我们为每个表单字段调用了$form->field()方法来创建表单项，并通过$form->error()方法显示每个字段的验证错误信息。这样，当表单提交且验证失败时，用户可以在页面上看到具体的错误信息，从而知道需要修改哪些内容。

9.5.6 总结

通过本章节的学习，我们掌握了在Yii2项目中为“添加文章”页面实现模型验证的完整流程。从定义验证规则到在控制器中处理表单提交，再到在视图中显示验证错误信息，每一步都至关重要。模型验证不仅提高了数据的质量，还增强了应用的健壮性和用户体验。在未来的开发中，你可以根据实际需求，灵活定义更多的验证规则，以满足不同业务场景的需求。