本教程详细介绍了如何在 laravel 8 中，通过 eloquent orm 的模型关联功能，高效且优雅地统计每个分类（category）下关联的文章（post）数量。我们将学习如何定义 `hasmany` 关系，并利用 `withcount` 方法简化数据查询，避免手动编写复杂的 sql join 语句，从而获取包含分类名称及其对应文章总数的结果集。
在 Web 应用开发中，统计不同类别下关联项目的数量是一个非常常见的需求，例如统计每个分类下的文章数、每个用户发布的帖子数等。传统的做法可能涉及编写复杂的 SQL JOIN 语句和聚合函数，但这往往会降低代码的可读性和维护性。Laravel 的 Eloquent ORM 提供了一种更优雅、更符合面向对象思想的解决方案。
准备工作：模型与数据库表
为了实现分类文章数量的统计，我们首先需要确保拥有相应的数据库表和 Eloquent 模型。
假设我们有两个数据库表：categories 和 posts。
-
categories 表：
- id (主键)
- name (分类名称)
- created_at, updated_at (时间戳)
-
posts 表：
- id (主键)
- category_id (外键，关联 categories 表的 id)
- title (文章标题)
- content (文章内容)
- created_at, updated_at (时间戳)
同时，我们需要为这两个表创建对应的 Eloquent 模型：Category 和 Post。
app/Models/Category.php (示例)
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Category extends Model
{
use HasFactory;
protected $fillable = ['name'];
// ... 其他属性和方法
}app/Models/Post.php (示例)
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Post extends Model
{
use HasFactory;
protected $fillable = ['category_id', 'title', 'content'];
// ... 其他属性和方法
}定义 Eloquent 模型关联
要让 Eloquent 知道 Category 和 Post 之间存在关系，我们需要在 Category 模型中定义一个关联方法。由于一个分类可以拥有多篇文章，这是一种“一对多”（One-to-Many）的关系。在 Category 模型中，我们使用 hasMany 方法来定义这个关系。
在 app/Models/Category.php 文件中添加 posts 方法：
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Category extends Model
{
use HasFactory;
protected $fillable = ['name'];
/**
* 获取该分类下的所有文章。
*/
public function posts()
{
return $this->hasMany(Post::class);
}
}这个 posts() 方法告诉 Laravel，一个 Category 模型实例可以通过 posts 属性访问所有关联的 Post 模型实例。
使用 withCount 统计关联数量
定义了模型关联后，统计每个分类下的文章数量就变得非常简单。Laravel 提供了 withCount 方法，它可以在查询父模型时，自动计算并添加一个 _count 属性，其中包含关联模型的数量。
要获取所有分类及其对应的文章数量，你可以在控制器或任何需要的地方执行以下查询：
use App\Models\Category;
$categoriesWithPostCounts = Category::withCount('posts')->get();
// $categoriesWithPostCounts 现在是一个 Category 模型的集合，
// 每个模型都包含一个名为 'posts_count' 的属性代码解析：
- Category::withCount('posts')：这会指示 Eloquent 在查询 categories 表时，同时对每个分类执行一个子查询，统计其关联的 posts 数量。
- 'posts'：这里的参数是我们在 Category 模型中定义的关联方法名。
- get()：执行查询并返回结果集合。
执行此查询后，返回的每个 Category 模型实例都会额外包含一个名为 posts_count 的属性，其值就是该分类下文章的总数。
获取并展示结果
你可以像访问普通模型属性一样，访问 posts_count 属性。下面是一个简单的示例，展示如何遍历结果并输出每个分类的名称及其文章数量：
// 假设你在一个控制器方法中
public function index()
{
$categoriesWithPostCounts = Category::withCount('posts')->get();
foreach ($categoriesWithPostCounts as $category) {
echo "分类名称: " . $category->name . " - 文章数量: " . $category->posts_count . "<br>";
}
// 你也可以将数据传递给视图
// return view('categories.index', compact('categoriesWithPostCounts'));
}示例输出：
分类名称: 技术 - 文章数量: 15 分类名称: 生活 - 文章数量: 8 分类名称: 娱乐 - 文章数量: 20
注意事项与进阶
-
自定义计数器名称： 如果你不喜欢默认的 posts_count 命名，可以自定义。
$categories = Category::withCount(['posts as total_articles'])->get(); // 此时，访问的是 $category->total_articles
-
在计数中添加条件： 你可以在计数时添加额外的查询条件，例如只统计已发布的文章。
$categories = Category::withCount(['posts' => function ($query) { $query->where('status', 'published'); }])->get(); // 此时，posts_count 将只包含状态为 'published' 的文章数量 性能考量： withCount 在底层会生成一个优化的子查询，通常比手动编写 JOIN 和 GROUP BY 语句更简洁高效。对于大多数场景，它的性能表现良好。
-
与 with 的区别：
- with('posts') 会加载所有关联的 Post 模型实例到内存中，当你需要访问每篇文章的详细信息时使用。
- withCount('posts') 只会加载关联模型的数量，而不会加载实际的关联模型数据，当你只需要计数时，它更轻量、更高效。
总结
通过 Eloquent 的模型关联和 withCount 方法，Laravel 提供了一种极其优雅和高效的方式来统计关联模型的数量。这种方法不仅减少了编写复杂 SQL 语句的需要，还大大提高了代码的可读性和可维护性，使得开发者能够更专注于业务逻辑的实现。在处理一对多或多对多关系中的计数需求时，withCount 是一个非常值得推荐的工具。
