Laravel Eloquent 实现状态分组统计与总计的完整方案-php教程-PHP中文网

Laravel Eloquent 实现状态分组统计与总计的完整方案

本文介绍如何使用 laravel eloquent 和 query builder 高效实现「关联表分组计数 + 全量总计」，避免多次查询，一次性获取各状态数量及“all”汇总行。

本文介绍如何使用 laravel eloquent 和 query builder 高效实现「关联表分组计数 + 全量总计」，避免多次查询，一次性获取各状态数量及“all”汇总行。

在实际业务中，常需统计某实体（如 applications）按关联状态（如 status 表）分类的数量，并同时展示总记录数（即“All”行）。若对每个状态单独调用 count()，不仅代码冗余、性能低下，还无法保证数据一致性（尤其在高并发场景下）。理想方案应一次查询完成所有统计，并兼容缺失状态（如 processed 和 failed 当前无对应应用，仍需显示 0）。

✅ 推荐方案：LEFT JOIN + GROUP BY + UNION ALL（兼顾完整性与准确性）

仅用 JOIN（内连接）会遗漏 status 表中无匹配应用的记录（如 id=3,4），导致 processed 和 failed 状态不出现。因此，必须使用 LEFT JOIN 从 status 主表出发：

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

use Illuminate\Support\Facades\DB;

$stats = DB::table('status')
    ->select(
        'status.id',
        DB::raw('UPPER(LEFT(status.desc, 1)) || LOWER(SUBSTRING(status.desc, 2)) as status_name'), // 首字母大写（如 'completed' → 'Completed'）
        DB::raw('COUNT(applications.id) as count')
    )
    ->leftJoin('applications', function ($join) {
        $join->on('status.id', '=', 'applications.status_id')
             ->where('applications.is_active', true);
    })
    ->groupBy('status.id', 'status.desc')
    ->orderBy('status.id')
    ->get();

// 构造“All”行
$total = $stats->sum('count');
$allRow = (object) [
    'id' => null,
    'status_name' => 'All',
    'count' => $total
];

// 合并结果（All 在首行）
$result = collect([$allRow])->merge($stats)->values();

? 关键点说明：

LEFT JOIN 确保所有 status 记录都参与统计，即使无匹配应用，COUNT(applications.id) 自动为 0；

WHERE 条件置于 JOIN ON 子句内（而非 WHERE 后），避免将 LEFT JOIN 退化为 INNER JOIN；

使用 UPPER/LOWER 或 ucwords()（PHP端处理）实现标题格式化，更灵活可控。

⚠️ 注意事项

Eloquent 模型关联优化：若已定义 Status 模型及其 applications() 关系，可改用 Eloquent 方式（但需注意 withCount() 不支持 LEFT JOIN 的零值保留，仍推荐原生查询）：
```
// 不推荐用于零值场景 —— withCount 默认 INNER JOIN
Status::withCount(['applications as count' => fn($q) => $q->where('is_active', true)])->get();
```
数据库兼容性：DB::raw() 中的字符串函数（如 UPPER, SUBSTRING）在 MySQL/PostgreSQL 语法略有差异，生产环境建议统一用 PHP 处理格式化：
```
$stats->map(function ($item) {
    $item->status_name = ucfirst($item->desc);
    return $item;
});
```
性能提示：确保 applications.status_id 和 applications.is_active 字段有联合索引：
```
CREATE INDEX idx_app_status_active ON applications(status_id, is_active);
```