6.5.3 实现其他栏目的文章内容查询-Yii2框架从入门到精通(上)

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

6.5.3 实现其他栏目的文章内容查询

在Yii2框架中，构建一个多栏目内容管理系统（CMS）时，实现不同栏目下文章内容的查询是一个核心功能。这不仅能提升用户体验，还能帮助内容创作者有效管理和分类他们的作品。本章节将详细探讨如何在Yii2项目中实现其他栏目的文章内容查询，包括数据库设计、模型建立、控制器编写、视图展示以及使用ActiveQuery进行高级查询技巧。

6.5.3.1 数据库设计

首先，我们需要设计一个能够支持多栏目的数据库结构。一般而言，至少需要以下几个表：

articles（文章表）：存储文章的基本信息，如ID、标题、内容、发布时间等。
categories（栏目表）：存储栏目的基本信息，如ID、名称、描述等。
article_category（文章与栏目关联表）：存储文章与栏目之间的多对多关系，通常包含文章ID和栏目ID。

articles 表结构示例：

CREATE TABLE `articles` (
  `id` INT AUTO_INCREMENT PRIMARY KEY,
  `title` VARCHAR(255) NOT NULL,
  `content` TEXT NOT NULL,
  `publish_time` DATETIME NOT NULL,
  ...
);

categories 表结构示例：

CREATE TABLE `categories` (
  `id` INT AUTO_INCREMENT PRIMARY KEY,
  `name` VARCHAR(255) NOT NULL,
  `description` TEXT,
  ...
);

article_category 表结构示例：

CREATE TABLE `article_category` (
  `article_id` INT,
  `category_id` INT,
  PRIMARY KEY (`article_id`, `category_id`),
  FOREIGN KEY (`article_id`) REFERENCES `articles`(`id`),
  FOREIGN KEY (`category_id`) REFERENCES `categories`(`id`)
);

6.5.3.2 模型建立

在Yii2中，每个数据库表通常对应一个模型（Model）。我们将创建Article, Category, 和一个ArticleCategory（如果需要处理复杂的关联逻辑，可能不需要单独的模型，直接使用关系定义在Article和Category模型中即可）。

Article.php 示例：

namespace app\models;
use Yii;
use yii\db\ActiveRecord;
class Article extends ActiveRecord
{
    public function getCategories()
    {
        return $this->hasMany(Category::className(), ['id' => 'category_id'])
            ->viaTable('article_category', ['article_id' => 'id']);
    }
    // ... 其他方法
}

Category.php 示例：

namespace app\models;
use Yii;
use yii\db\ActiveRecord;
class Category extends ActiveRecord
{
    public function getArticles()
    {
        return $this->hasMany(Article::className(), ['id' => 'article_id'])
            ->viaTable('article_category', ['category_id' => 'id']);
    }
    // ... 其他方法
}

6.5.3.3 控制器编写

在控制器中，我们需要编写方法来处理文章查询请求，并根据栏目ID筛选出相应栏目的文章。

ArticleController.php 示例：

namespace app\controllers;
use Yii;
use yii\web\Controller;
use app\models\Article;
use app\models\Category;
class ArticleController extends Controller
{
    public function actionIndex($categoryId = null)
    {
        $query = Article::find();
        if ($categoryId) {
            $category = Category::findOne(['id' => $categoryId]);
            if ($category) {
                $query->innerJoinWith(['categories' => function ($query) use ($category) {
                    $query->andWhere(['category.id' => $category->id]);
                }]);
            } else {
                // 处理类别ID不存在的情况
                Yii::$app->session->setFlash('error', 'Category not found.');
                return $this->redirect(['index']);
            }
        }
        $articles = $query->all();
        return $this->render('index', [
            'articles' => $articles,
            'categoryId' => $categoryId,
        ]);
    }
    // ... 其他方法
}

6.5.3.4 视图展示

在视图中，我们需要根据控制器传递的数据渲染出文章列表，并可能包括一些导航或筛选元素以支持用户访问不同栏目。

views/article/index.php 示例：

<?php
use yii\helpers\Html;
/* @var $this yii\web\View */
/* @var $articles app\models\Article[] */
/* @var $categoryId integer|null */
?>
<h1><?= Html::encode($this->title) ?></h1>
<?php if ($categoryId): ?>
    <p>当前栏目: <?= Html::encode(Category::findOne($categoryId)->name) ?></p>
<?php endif; ?>
<ul>
    <?php foreach ($articles as $article): ?>
        <li><?= Html::a(Html::encode($article->title), ['view', 'id' => $article->id]) ?></li>
    <?php endforeach; ?>
</ul>
<?php if ($categories = Category::find()->all()): ?>
    <div>
        <h2>浏览其他栏目:</h2>
        <ul>
            <?php foreach ($categories as $category): ?>
                <li><?= Html::a(Html::encode($category->name), ['index', 'categoryId' => $category->id]) ?></li>
            <?php endforeach; ?>
        </ul>
    </div>
<?php endif; ?>

6.5.3.5 使用ActiveQuery进行高级查询

Yii2的ActiveQuery提供了丰富的接口来进行复杂的数据查询。在上述例子中，我们已经使用了innerJoinWith来连接文章和栏目表，并基于栏目ID进行筛选。但ActiveQuery的能力远不止于此，你还可以使用where(), orderBy(), groupBy(), limit(), offset()等方法来进一步定制你的查询。

例如，如果你想要查询某个栏目下点击量最高的前10篇文章，你可以这样做：

$query = Article::find()
    ->innerJoinWith(['categories' => function ($query) use ($categoryId) {
        $query->andWhere(['category.id' => $categoryId]);
    }])
    ->orderBy(['views' => SORT_DESC]) // 假设文章表有views字段表示点击量
    ->limit(10);
$topArticles = $query->all();