当前位置：首页 > 文章列表 > 文章 > php教程 > Laravel8查询补全缺失月份方法

Laravel8查询补全缺失月份方法

2025-07-30 16:45:29 0浏览收藏

大家好，我们又见面了啊~本文《Laravel 8 查询填充缺失月份数据方法》的内容中将会涉及到等等。如果你正在学习文章相关知识，欢迎关注我，以后会给大家带来更多文章相关文章，希望我们能一起进步！下面就开始本文的正式内容~

使用 Laravel 8 查询填充缺失月份的 SQL 数据

在 Laravel 8 项目中，我们经常需要统计按月分组的数据，例如每月删除用户总数。然而，当某些月份没有数据时，查询结果会跳过这些月份，导致图表数据不完整。本文将介绍一种在查询结果后进行后处理的方法，通过循环遍历指定时间范围内的月份，将缺失月份的数据补全，确保图表数据完整性。

首先，回顾一下原始的查询语句：

$data = User::selectRaw('DATE_FORMAT(created_at, "%Y-%m") as date, COUNT(*) as total')
                ->groupByRaw('DATE_FORMAT(created_at, "%Y-%m")')
                ->withTrashed()
                ->whereNotNull('deleted_at')
                ->get();

这段代码会返回一个包含 date (YYYY-MM 格式) 和 total (删除用户总数) 的集合。如果某个月份没有删除用户，那么这个月份就不会出现在结果集中。

解决这个问题的关键在于，在查询结果返回后，对结果进行后处理，填充缺失的月份数据。以下是一种实现方法：

use Carbon\Carbon;
use Illuminate\Support\Collection;
use stdClass;

// 假设 $data 是上面查询语句返回的结果

$start = Carbon::today()->subYear(); // 设置起始日期，例如一年前
$end = Carbon::today(); // 设置结束日期，例如今天

$loop = $start->copy();

while ($loop->lessThanOrEqualTo($end)) {
    $exists = $data->first(function($item) use ($loop) {
        return $item->date == $loop->format('Y-m');
    });

    if (!$exists) {
        $row = new stdClass();
        $row->date = $loop->copy()->format('Y-m');
        $row->total = 0;
        $data->push($row);
    }

    $loop->addMonth(); // 循环到下个月
}

这段代码首先定义了起始日期和结束日期，然后循环遍历这两个日期之间的每个月。对于每个月，它会检查 $data 集合中是否存在该月份的数据。如果不存在，则创建一个新的对象，包含 date 和 total 属性，并将 total 设置为 0，然后将该对象添加到 $data 集合中。

为了提高代码的可重用性，可以将上述逻辑封装成一个函数：

use Carbon\Carbon;
use Illuminate\Support\Collection;
use stdClass;

function fillEmptyMonths(Collection $data, Carbon $start, Carbon $end): Collection
{
    $loop = $start->copy();

    // Loop using diff in months rather than running comparison over and over.
    for ($months = 0; $months <= $start->diffInMonths($end); $months++) {

        if ($data->where('date', '=', $loop->format('Y-m'))->isEmpty()) {
            $row = new stdClass();
            $row->date = $loop->copy()->format('Y-m');
            $row->total = 0;
            $data->push($row);
        }

        $loop->addMonth();
    }

    return $data;
}

使用这个函数非常简单：

$data = User::selectRaw('DATE_FORMAT(created_at, "%Y-%m") as date, COUNT(*) as total')
                ->groupByRaw('DATE_FORMAT(created_at, "%Y-%m")')
                ->withTrashed()
                ->whereNotNull('deleted_at')
                ->get();

$start = Carbon::today()->subYear();
$end = Carbon::today();

$data = fillEmptyMonths($data, $start, $end);

注意事项：