在 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 carbonCarbon; use IlluminateSupportCollection; 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 CarbonCarbon; use IlluminateSupportCollection; 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);
注意事项：
- 确保安装了 Carbon 库。可以使用 composer require nesbot/carbon 命令进行安装。
- 起始日期和结束日期可以根据实际需求进行调整。
- 可以根据需要扩展该函数，以支持不同的时间间隔（例如，天、年）。
总结：
通过在查询结果后进行后处理，我们可以轻松地填充缺失的月份数据，确保图表数据的完整性。这种方法简单易懂，并且具有很高的灵活性和可重用性。 这种方法避免了复杂的 sql 查询，使得代码更加清晰易于维护。
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
