Laravel 8 中使用 Eloquent 高效统计每个分类下的文章数量

在构建内容管理系统或博客平台时，我们常常需要展示每个分类下有多少篇文章。这不仅有助于用户了解内容分布，也对后台数据分析至关重要。Laravel 作为 PHP 领域中最受欢迎的框架之一，其 Eloquent ORM 提供了强大而优雅的方式来处理这类需求。本文将带你深入探讨如何在 Laravel 8 中高效地实现“统计每个分类下的文章数量”，并兼顾性能与可读性。

假设我们有两个模型：Category 和 Post，它们之间是一对多的关系——一个分类可以包含多篇文章。数据库结构大致如下：

php
// categories 表
id | name | slug

// posts 表
id | title | content | category_id | status

我们的目标是获取所有分类，并附带每类中已发布文章的数量，最终返回类似这样的数据：

php [ ['name' => '科技', 'post_count' => 15], ['name' => '生活', 'post_count' => 8], ['name' => '旅行', 'post_count' => 12] ]

使用 withCount 实现高效统计

Laravel 的 Eloquent 提供了一个非常实用的方法 —— withCount()，它可以在一次查询中通过 SQL 的 COUNT 聚合函数计算关联模型的数量，并自动将结果注入到主模型的一个属性中。

首先，在 Category 模型中定义与 Post 的关联关系：

php
// app/Models/Category.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Category extends Model
{
public function posts()
{
return $this->hasMany(Post::class);
}
}

接着，在控制器中调用 withCount('posts')：

php
// app/Http/Controllers/CategoryController.php
use App\Models\Category;

$categories = Category::withCount('posts')->get();

foreach ($categories as $category) {
echo $category->name . ' 有 ' . $category->posts_count . ' 篇文章';
}

此时，Eloquent 会生成一条包含左连接和 COUNT 的 SQL 查询，形如：

sql SELECT categories.*, (SELECT COUNT(*) FROM posts WHERE posts.category_id = categories.id) AS posts_count FROM categories;

这种方法的优势在于只执行一次数据库查询，避免了经典的 N+1 查询问题。相比循环中逐个统计，性能提升显著。

添加条件过滤：仅统计已发布文章

实际项目中，我们往往只想统计状态为“已发布”的文章。这时可以通过闭包形式进一步限定关联条件：

php $categories = Category::withCount(['posts as published_posts_count' => function ($query) { $query->where('status', 'published'); }])->get();

这里我们将统计字段重命名为 published_posts_count，以更清晰地表达含义。生成的 SQL 将自动加入 WHERE status = 'published' 条件，确保统计数据准确反映线上内容。

你也可以保留原始的 posts_count 同时添加带条件的计数：

php $categories = Category::withCount('posts') ->withCount(['posts as published_posts_count' => fn($q) => $q->where('status', 'published')]) ->get();

这样每个分类对象就会同时拥有 posts_count 和 published_posts_count 两个属性。

排序与限制：按文章数量排序

有时我们需要按文章数量从高到低展示热门分类。得益于 withCount 返回的是普通查询构造器，我们可以直接链式调用 orderBy：

php $popularCategories = Category::withCount('posts') ->orderBy('posts_count', 'desc') ->take(5) ->get();

这段代码能轻松实现“最受欢迎的前五个分类”功能，常用于首页侧边栏推荐区域。

处理空分类：是否包含无文章的分类？

默认情况下，withCount 仍会包含那些没有文章的分类，只不过计数为 0。如果你只想显示至少有一篇文章的分类，可以使用 having 方法：

php $categoriesWithPosts = Category::withCount('posts') ->having('posts_count', '>', 0) ->get();

注意：having 必须作用于聚合字段，因此不能用 where 替代。这也是为什么 withCount 如此重要的原因——它让这些高级筛选成为可能。

性能优化建议

尽管 withCount 已经足够高效，但在数据量巨大时仍需注意几点：

1. 为外键建立索引：确保 posts.category_id 字段上有数据库索引，否则 COUNT 查询会变得缓慢。
2. 避免在大表上频繁执行全量统计：如果分类和文章数量极多，考虑缓存结果。例如使用 Laravel 的缓存系统：

php $categories = Cache::remember('category_post_counts', 3600, function () { return Category::withCount('posts')->get(); });

这样每小时更新一次统计数据，减轻数据库压力。

1. 结合分页场景：若需分页展示分类及其文章数，withCount 依然适用，不会破坏分页逻辑。

扩展思路：多层级分类或标签统计

虽然本文聚焦于单级分类，但同样的思路可扩展至树形分类或多对多关系。比如使用 withCount 统计某个标签被多少文章引用，或者父分类下所有子分类的文章总数汇总。

只需合理设计模型关系，并灵活运用闭包约束条件，即可应对复杂业务场景。

在整个开发过程中，Laravel 的 Eloquent 不仅让我们写出语义清晰的代码，还通过底层优化保障了执行效率。withCount 这个看似简单的方法，实则凝聚了框架设计者对开发者体验与数据库性能的双重考量。当你下一次面对“XX有多少YYY”的统计需求时，不妨第一时间想到它——简洁、高效、原生支持，这才是现代 PHP 开发应有的模样。