5.4 项目实现迭代六：在“文章添加”页面实现数据插入-Yii2框架从入门到精通(上)

当前位置:　首页>> 技术小册>> Yii2框架从入门到精通(上)

5.4 项目实现迭代六：在“文章添加”页面实现数据插入

在Yii2框架的项目开发过程中，实现数据的增删改查（CRUD）是构建动态网站或应用程序的基础。本章节将聚焦于“文章添加”功能的实现，即如何在Yii2项目中创建一个表单页面，允许用户输入文章信息，并将这些数据保存到数据库中。我们将通过详细步骤讲解如何配置控制器、模型、视图以及数据库迁移，来完成这一功能的开发。

5.4.1 准备工作

在开始编码之前，请确保你的Yii2项目已经正确设置，并且已经创建了用于存储文章数据的数据库表。假设我们已经有一个名为article的表，包含字段如id（主键，自增）、title（标题）、content（内容）、status（状态，例如发布或草稿）和created_at（创建时间）等。

5.4.2 创建模型

首先，我们需要一个与article表对应的模型类。在models目录下创建一个名为Article.php的PHP文件，并编写如下代码：

<?php
namespace app\models;
use Yii\Db\ActiveRecord;
class Article extends ActiveRecord
{
    // 关联数据库表
    public static function tableName()
    {
        return '{{%article}}';
    }
    // 验证规则
    public function rules()
    {
        return [
            [['title', 'content'], 'required'],
            ['title', 'string', 'max' => 255],
            ['content', 'string'],
            ['status', 'integer'],
        ];
    }
    // 场景定义
    public function scenarios()
    {
        $scenarios = parent::scenarios();
        $scenarios['create'] = ['title', 'content', 'status'];
        return $scenarios;
    }
}

在这个模型中，我们定义了与article表的关联、数据验证规则以及特定的使用场景（在本例中为create）。

5.4.3 创建控制器

接下来，在controllers目录下创建一个用于处理文章相关操作的控制器ArticleController.php，并添加actionCreate方法来处理文章添加的逻辑：

<?php
namespace app\controllers;
use Yii;
use yii\web\Controller;
use app\models\Article;
class ArticleController extends Controller
{
    public function actionCreate()
    {
        $model = new Article();
        if ($model->load(Yii::$app->request->post()) && $model->save()) {
            Yii::$app->session->setFlash('success', '文章添加成功！');
            return $this->redirect(['index']); // 假设有一个index动作显示文章列表
        }
        return $this->render('create', [
            'model' => $model,
        ]);
    }
}

在这个控制器中，我们首先实例化了一个Article模型对象。然后，使用load()方法从POST请求中加载数据到模型中，并尝试使用save()方法保存这些数据到数据库。如果保存成功，则设置会话消息并重定向到文章列表页面；如果失败，则渲染create视图，并将模型对象传递给视图以便显示表单和错误信息。

5.4.4 创建视图

现在，在views/article目录下创建一个名为create.php的视图文件，用于展示文章添加表单：

<?php
use yii\helpers\Html;
use yii\widgets\ActiveForm;
/* @var $this yii\web\View */
/* @var $model app\models\Article */
/* @var $form yii\widgets\ActiveForm */
?>
<div class="article-create">
    <h1>添加文章</h1>
    <?php $form = ActiveForm::begin(); ?>
    <?= $form->field($model, 'title')->textInput(['maxlength' => true]) ?>
    <?= $form->field($model, 'content')->textarea(['rows' => 6]) ?>
    <?= $form->field($model, 'status')->dropDownList([
        0 => '草稿',
        1 => '发布',
    ], ['prompt' => '请选择状态']) ?>
    <div class="form-group">
        <?= Html::submitButton('提交', ['class' => 'btn btn-primary']) ?>
    </div>
    <?php ActiveForm::end(); ?>
</div>

在这个视图中，我们使用了Yii2的ActiveForm和Html助手类来创建表单元素。$form->field()方法用于生成带有标签、输入字段和验证错误的表单项。$model对象与表单绑定，允许Yii2自动处理数据验证和填充。

5.4.5 配置路由

最后，确保你的URL管理器能够识别到ArticleController的create动作。通常，在config/web.php的urlManager组件中配置路由规则，但Yii2也支持通过控制器名/动作名的方式直接访问（如果启用了enablePrettyUrl和配置了.htaccess文件）。

// config/web.php 示例路由配置
'urlManager' => [
    'enablePrettyUrl' => true,
    'showScriptName' => false,
    'rules' => [
        // 其他路由规则...
        'article/create' => 'article/create', // 可选配置，具体取决于你的URL管理策略
    ],
],

5.4.6 测试功能

完成以上步骤后，通过浏览器访问文章添加页面的URL（通常是http://yourproject.com/article/create），你应该能看到一个包含标题、内容、状态选择框和提交按钮的表单。填写表单并提交后，如果一切配置正确，数据将被保存到数据库中，并且浏览器将重定向到文章列表页面（或根据actionCreate方法中的重定向逻辑进行跳转），同时显示添加成功的消息。

总结

本章节详细介绍了在Yii2框架中实现“文章添加”功能的完整流程，包括模型、控制器、视图的创建以及路由的配置。通过这一迭代，你的Yii2项目已经具备了处理用户输入并存储到数据库的基本能力，为后续的功能开发奠定了坚实的基础。记得在开发过程中不断测试，确保每个功能都按预期工作。