怎样在ThinkPHP中实现CMS栏目与文章关联【实战】-ThinkPHP-PHP中文网

在thinkphp中实现cms栏目与文章关联，需设计category与article一对多数据库关系，定义hasmany/belongsto双向模型关联，控制器中用where或with方法查询，模板中直接调用{$article.category.name}，支持无限级导航和多栏目扩展。

怎样在thinkphp中实现cms栏目与文章关联【实战】

在 ThinkPHP 中实现 CMS 栏目与文章的关联，核心是设计合理的数据库关系、定义模型之间的关联方法，并在控制器和模板中正确调用。关键不在于堆砌功能，而在于让“栏目”和“文章”真正可查、可嵌套、可扩展。

一、数据库设计：明确一对多关系

栏目（category）与文章（article）是典型的一对多关系：一个栏目下有多篇文章，一篇文章只属于一个栏目（单栏目的简单 CMS 场景）。建议字段如下：

category 表：id（主键）、name、slug（英文别名，用于 URL）、pid（支持无限级，0 为顶级）、sort（排序）、status（是否启用）
article 表：id、title、content、cate_id（外键，关联 category.id）、cover（封面图）、status、create_time、update_time

注意：cate_id 必须加索引（提高查询效率），且推荐设为非空（NOT NULL），避免文章“无归属”。

二、模型定义：用 hasMany 和 belongsTo 建立双向关联

ThinkPHP 6/7 推荐使用模型的关联定义，而非手写 JOIN 查询。在 app\model\Category.php 中：

class Category extends Model
{
    // 关联文章：一个栏目有多个文章
    public function articles()
    {
        return $this->hasMany(Article::class, 'cate_id', 'id');
    }

    // 可选：自关联获取子栏目（用于导航树）
    public function children()
    {
        return $this->hasMany(Category::class, 'pid', 'id')->order('sort');
    }
}

在 app\model\Article.php 中补充反向关联：

class Article extends Model
{
    // 文章属于某个栏目
    public function category()
    {
        return $this->belongsTo(Category::class, 'cate_id', 'id');
    }
}

这样就能用 $article->category->name 获取栏目名，或 $category->articles 拿到全部文章集合。

三、控制器中灵活调用：列表、详情、筛选都靠它

以文章列表页为例（按栏目查看）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

// 控制器：app\controller\Article.php
public function list($cid = 0)
{
    $category = Category::find($cid);
    if (!$category || $category->status != 1) {
        throw new HttpException(404, '栏目不存在或已下线');
    }

    $articles = Article::where('cate_id', $cid)
        ->where('status', 1)
        ->order('create_time', 'desc')
        ->paginate(10);

    return view('', [
        'category' => $category,
        'articles' => $articles,
    ]);
}

如果想在文章详情页同时显示栏目信息，直接用关联加载：

public function detail($id)
{
    $article = Article::with('category')->find($id);
    if (!$article || $article->status != 1) {
        throw new HttpException(404);
    }
    return view('', ['article' => $article]);
}

模板中即可写 {$article.category.name} 或 {$article.category.slug} 生成 SEO 友好的链接。

四、进阶技巧：支持多栏目（标签式）、无限级导航

若需“一篇文章属于多个栏目”（如新闻+技术+原创），则需中间表 article_category，改用 belongsToMany 多对多关联：

新增表：id、article_id、category_id
Article 模型中定义：return $this->belongsToMany(Category::class, 'article_category', 'article_id', 'category_id');
Category 模型中对应：return $this->belongsToMany(Article::class, 'article_category', 'category_id', 'article_id');

无限级栏目导航可用递归 + 缓存优化：

// 在 Category 模型中加静态方法
public static function getTree($pid = 0, $level = 0)
{
    $list = cache('category_tree_' . $pid);
    if (false === $list) {
        $list = self::where('pid', $pid)->where('status', 1)->order('sort')->select();
        foreach ($list as $k => $v) {
            $list[$k]['children'] = self::getTree($v['id'], $level + 1);
        }
        cache('category_tree_' . $pid, $list, 3600);
    }
    return $list;
}

控制器中调用 Category::getTree() 即可获得带层级结构的全站导航数据。

不复杂但容易忽略：关联字段命名要统一、查询时善用 with() 避免 N+1 查询、栏目缓存能显著提升前台性能。实战中先跑通单栏目逻辑，再按需扩展多栏目或父子结构。