填充 Laravel Eloquent 查询中缺失的月份数据

use App\Models\User;
use Carbon\Carbon;

$data = User::selectRaw('DATE_FORMAT(deleted_at, "%Y-%m") as date, COUNT(*) as total')
                ->withTrashed() // 包含软删除的用户
                ->whereNotNull('deleted_at') // 只统计已删除的用户
                ->groupByRaw('DATE_FORMAT(deleted_at, "%Y-%m")')
                ->get();

use Carbon\Carbon;
use Illuminate\Support\Collection; // 确保引入 Collection 类

// 获取原始数据（如上文所示）
$data = User::selectRaw('DATE_FORMAT(deleted_at, "%Y-%m") as date, COUNT(*) as total')
                ->withTrashed()
                ->whereNotNull('deleted_at')
                ->groupByRaw('DATE_FORMAT(deleted_at, "%Y-%m")')
                ->get();

// 定义时间范围
$startDate = Carbon::parse('2021-01-01'); // 示例：从2021年1月开始
// 或者：$startDate = User::orderBy('deleted_at', 'asc')->first()->deleted_at->startOfMonth(); // 从最早的删除日期开始
$endDate = Carbon::now()->endOfMonth(); // 结束日期为当前月份的月末

// 创建一个可复用的函数来填充缺失月份
function fillEmptyMonths(Collection $data, Carbon $start, Carbon $end): Collection
{
    $loopDate = $start->copy()->startOfMonth(); // 从起始月份的第一天开始循环

    // 遍历从起始月份到结束月份的所有月份
    // 使用 diffInMonths 确保循环覆盖所有月份
    for ($months = 0; $months <= $start->diffInMonths($end); $months++) {
        $currentMonthFormat = $loopDate->format('Y-m');

        // 检查当前月份是否已存在于数据集合中
        if ($data->where('date', '=', $currentMonthFormat)->isEmpty()) {
            // 如果不存在，则创建一个新的 stdClass 对象作为占位符
            $row = new \stdClass();
            $row->date = $currentMonthFormat;
            $row->total = 0; // 设置默认值为 0
            $data->push($row); // 将新创建的行添加到集合中
        }

        $loopDate->addMonth(); // 移动到下一个月
    }

    // 最后，为了确保图表数据按时间顺序排列，对集合进行排序
    return $data->sortBy('date')->values();
}

// 调用函数填充数据
$filledData = fillEmptyMonths($data, $startDate, $endDate);

// $filledData 现在包含所有月份的数据，缺失月份的 total 为 0
// 例如：
// [
//     { "date": "2021-01", "total": 15 },
//     { "date": "2021-02", "total": 0 },
//     { "date": "2021-03", "total": 22 },
//     // ... 更多月份
// ]