7.2.3 “文章栏目”下拉列表框-Yii2框架从入门到精通(中)

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

### 7.2.3 “文章栏目”下拉列表框

在Web开发中，尤其是在使用Yii2框架构建内容管理系统（CMS）或博客平台时，实现一个功能完善的“文章栏目”（或称为“分类”）下拉列表框是必不可少的一部分。这一功能允许用户（无论是管理员还是普通用户，视权限而定）在发布或编辑文章时，能够轻松选择文章所属的栏目，从而实现内容的组织化和分类管理。本章节将详细介绍如何在Yii2框架中创建并集成一个“文章栏目”下拉列表框，包括数据库设计、模型建立、视图渲染以及控制器逻辑处理等方面。

#### 7.2.3.1 数据库设计

首先，我们需要为“文章栏目”设计数据库表。通常，这样的表会包含几个基本字段：ID（主键）、栏目名称、描述（可选）、创建时间、更新时间以及状态（用于标记栏目是否可用）。以下是一个简单的SQL建表语句示例：

```sql
CREATE TABLE `article_category` (
  `id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  `name` VARCHAR(255) NOT NULL COMMENT '栏目名称',
  `description` TEXT COMMENT '栏目描述',
  `created_at` INT UNSIGNED NOT NULL COMMENT '创建时间',
  `updated_at` INT UNSIGNED NOT NULL COMMENT '更新时间',
  `status` TINYINT UNSIGNED NOT NULL DEFAULT 1 COMMENT '状态：1-启用，0-禁用'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文章栏目表';
```

在这个表中，`created_at`和`updated_at`字段通常使用UNIX时间戳来存储时间信息，便于后续的排序和筛选操作。`status`字段用于控制栏目的可用性，增强了系统的灵活性。

#### 7.2.3.2 模型建立

在Yii2中，每个数据库表都应该对应一个模型（Model），它封装了与数据库表交互的逻辑。对于`article_category`表，我们可以创建一个`ArticleCategory`模型类。使用Gii工具可以快速生成这个模型，但手动创建也是一个很好的学习过程。

在`models`目录下创建`ArticleCategory.php`文件，并定义模型类：

```php
namespace app\models;

use Yii;

class ArticleCategory extends \yii\db\ActiveRecord
{
    /**
     * {@inheritdoc}
     */
    public static function tableName()
    {
        return '{{%article_category}}';
    }

/**
     * {@inheritdoc}
     */
    public function rules()
    {
        return [
            [['name'], 'required'],
            [['name'], 'string', 'max' => 255],
            [['description'], 'string'],
            [['created_at', 'updated_at', 'status'], 'integer'],
        ];
    }

// 可以添加其他方法，如获取所有可用栏目
    public static function getActiveCategories()
    {
        return self::find()->where(['status' => 1])->all();
    }
}
```

这里，`tableName`方法定义了模型对应的数据库表名（支持表前缀），`rules`方法定义了验证规则，确保数据的合法性和完整性。`getActiveCategories`方法用于获取所有启用的栏目，这在渲染下拉列表框时非常有用。

#### 7.2.3.3 视图渲染

在Yii2中，视图（View）负责展示数据给用户。为了渲染“文章栏目”下拉列表框，我们需要在相应的表单视图中添加HTML代码和Yii2的表单组件。

假设我们在`views/article/create.php`或`views/article/update.php`视图中处理文章的创建或更新，可以添加以下代码来渲染下拉列表框：

```php
use yii\helpers\Html;
use yii\widgets\ActiveForm;
use app\models\ArticleCategory;

/* @var $this yii\web\View */
/* @var $model app\models\Article */
/* @var $form yii\widgets\ActiveForm */

$form = ActiveForm::begin();

// ... 其他表单字段

echo $form->field($model, 'category_id')->dropDownList(
    ArrayHelper::map(ArticleCategory::getActiveCategories(), 'id', 'name'),
    ['prompt' => '请选择文章栏目']
);

// ... 其他表单字段

ActiveForm::end();
```

这里，`dropDownList`方法用于生成下拉列表框，它接受两个主要参数：第一个参数是一个数组，定义了选项的键值对（这里使用`ArrayHelper::map`方法从`ArticleCategory`模型中获取所有启用的栏目，并映射其`id`为键，`name`为值）；第二个参数是一个数组，可以包含额外的HTML属性，如`prompt`用于显示一个空的提示选项。

#### 7.2.3.4 控制器逻辑处理

最后，在控制器中处理文章数据的创建或更新时，需要确保能够正确处理从下拉列表框提交的`category_id`字段。

以`ArticleController`中的`create`和`update`动作为例，通常你会在这些动作中看到类似以下的代码片段，它们处理表单的提交：

```php
// 假设是ArticleController的create或update动作
public function actionCreate()
{
    $model = new Article();

if ($model->load(Yii::$app->request->post()) && $model->save()) {
        // 数据保存成功后的逻辑
        return $this->redirect(['view', 'id' => $model->id]);
    }

return $this->render('create', [
        'model' => $model,
    ]);
}

// update动作类似，但会先根据ID加载文章模型
```

在这个例子中，`$model->load(Yii::$app->request->post())`负责将请求中的数据填充到模型实例中，包括从下拉列表框提交的`category_id`。然后，调用`$model->save()`方法将模型数据保存到数据库中。

#### 总结

通过以上步骤，我们成功地在Yii2框架中创建并集成了“文章栏目”下拉列表框。这一功能不仅提升了用户体验，还使得文章内容的分类管理变得更加便捷和高效。在实际的项目开发中，你可能还需要根据具体需求对下拉列表框进行扩展，比如添加搜索功能、支持多级分类等。不过，这些高级功能通常都建立在上述基础之上的，掌握了基本原理后，再学习这些扩展功能将会更加容易。

该分类下的相关小册推荐：

Laravel(10.x)从入门到精通(六)

Laravel(10.x)从入门到精通(三)

经典设计模式PHP版

ThinkPHP项目开发实战

全面构建Magento2电商系统

PHP高并发秒杀入门与实战

全栈工程师修炼指南

Magento零基础到架构师(安装篇)

PHP底层原理及源码分析

Laravel(10.x)从入门到精通(十五)

Laravel(10.x)从入门到精通(五)

Laravel(10.x)从入门到精通(二)