Laravel Collection：多层分组后合并重复项并求和特定字段的教程-php教程-PHP中文网

laravel collection：多层分组后合并重复项并求和特定字段的教程

本教程详细讲解如何在Laravel Collection中处理复杂数据结构。针对多层分组后的数据，我们将学习如何合并具有相同特征的重复项，并对指定字段（如数量）进行求和，最终输出一个精简且聚合的数据集，这对于生成报告或交付单等场景至关重要。

引言：处理聚合数据的需求

在企业应用开发中，我们经常面临需要对数据进行聚合和汇总的场景。例如，在一个交付单系统中，用户可能会输入同一批次、同一类型和尺寸的商品多次，但最终在交付单上，我们需要将这些重复的条目合并，并显示它们的总数量。这不仅能提高数据可读性，也符合业务逻辑。

假设我们有以下原始数据结构，代表了圣诞树的销售明细，其中 line_items 是一个包含多个商品条目的集合：

[
  {
    "slot": 2,
    "pallet": "cghjh",
    "type": "NGR",
    "label": "purple",
    "size": "125-150",
    "amount": "30"
  },
  {
    "slot": 3,
    "pallet": "cghjh",
    "type": "NGR",
    "label": "purple",
    "size": "125-150",
    "amount": "30"
  },
  {
    "slot": 2,
    "pallet": "yghiuj",
    "type": "NGR",
    "label": "orange",
    "size": "150-175",
    "amount": "30"
  },
  {
    "slot": 3,
    "pallet": "cghjh",
    "type": "NOB",
    "label": "purple",
    "size": "125-150",
    "amount": "30"
  }
]

登录后复制

我们的目标是将其转换为以下聚合后的结构，其中 type 和 size 相同的条目被合并，amount 字段被求和，并且移除了 slot, pallet, label 等不必要的详细信息：

{
  "NGR": {
    "125-150": [
      {
        "type": "NGR",
        "size": "125-150",
        "amount": 60
      }
    ],
    "150-175": [
      {
        "type": "NGR",
        "size": "150-175",
        "amount": 30
      }
    ]
  },
  "NOB": {
    "125-150": [
      {
        "type": "NOB",
        "size": "125-150",
        "amount": 30
      }
    ]
  }
}

登录后复制

Laravel Collection 的基础分组

Laravel Collection 提供了强大的数据处理能力。首先，我们可以使用 groupBy 方法对数据进行多层分组。根据我们的需求，我们可以先按 type 分组，再按 size 分组：

use Illuminate\Support\Collection;

// 假设 $deliveryNote->line_items 是一个包含上述JSON数据的数组或Collection
$data = collect($deliveryNote->line_items)
    ->groupBy(['type', 'size']);

登录后复制

执行上述代码后，$data 将会得到一个嵌套的 Collection 结构，大致如下：

{
  "NGR": {
    "125-150": [
      {
        "slot": 2,
        "pallet": "cghjh",
        "type": "NGR",
        "label": "purple",
        "size": "125-150",
        "amount": "30"
      },
      {
        "slot": 3,
        "pallet": "cghjh",
        "type": "NGR",
        "label": "purple",
        "size": "125-150",
        "amount": "30"
      }
    ],
    "150-175": [
      {
        "slot": 2,
        "pallet": "yghiuj",
        "type": "NGR",
        "label": "orange",
        "size": "150-175",
        "amount": "30"
      }
    ]
  },
  "NOB": {
    "125-150": [
      {
        "slot": 3,
        "pallet": "cghjh",
        "type": "NOB",
        "label": "purple",
        "size": "125-150",
        "amount": "30"
      }
    ]
  }
}

登录后复制

这个结构已经非常接近我们想要的结果，它将相同 type 和 size 的条目归并到了一起。然而，我们还需要进一步处理，包括求和 amount 字段并精简每个条目的字段。

挑战：多层分组后的聚合操作

直接在 groupBy 之后使用 map 并尝试 sum('amount') 是行不通的，因为 groupBy 返回的是一个嵌套的 Collection。例如，以下尝试并不能得到正确的结果：

// 这是一个错误的尝试，无法达到预期效果
$data = collect($deliveryNote->line_items)
    ->groupBy(['type', 'size'])
    ->map(function ($item) {
        // 这里的 $item 是一个 Collection，其键是 size，值是 size 对应的条目集合
        // 直接 sum('amount') 会失败，因为它没有深入到最内层
        return $item->sum('amount');
    });

登录后复制

上述代码只会遍历第一层分组（type 的键），而无法深入到 size 对应的具体商品条目中去求和。我们需要一种方法来遍历所有分组层级，并在最内层执行聚合操作。

降重鸟

要想效果好，就用降重鸟。AI改写智能降低AIGC率和重复率。

113

查看详情

解决方案：嵌套 map 实现深度聚合

解决这个问题的关键在于利用 Collection 的链式调用和嵌套 map 方法，逐层深入到分组的最低层级进行处理。

核心思路：

首先使用 groupBy(['type', 'size']) 创建一个两层嵌套的 Collection。
对最外层 Collection（按 type 分组）使用 map 方法。
在第一个 map 的回调函数中，会得到一个按 size 分组的 Collection。对这个 Collection 再次使用 map 方法。
在第二个 map 的回调函数中，会得到一个包含相同 type 和 size 的所有原始条目的 Collection。此时，我们就可以对这个 Collection 进行 sum('amount') 操作，并构建新的精简数据结构。

完整代码示例：

use Illuminate\Support\Collection;

// 假设 $deliveryNote->line_items 是一个包含上述JSON数据的数组或Collection
$aggregatedData = collect($deliveryNote->line_items)
    ->groupBy(['type', 'size']) // 第一步：按 type 和 size 进行分组
    ->map(function (Collection $typeGroups) { // 第二步：遍历外层分组（按 type）
        // $typeGroups 是一个 Collection，其中键是 'size'，值是该 type 和 size 的所有条目
        return $typeGroups->map(function (Collection $sizeGroup) { // 第三步：遍历内层分组（按 size）
            // $sizeGroup 是一个 Collection，其中包含所有具有相同 type 和 size 的原始条目
            return [
                'type' => $sizeGroup->first()->type, // 从第一个条目获取 type
                'size' => $sizeGroup->first()->size, // 从第一个条目获取 size
                'amount' => $sizeGroup->sum('amount'), // 对所有条目的 amount 字段求和
            ];
        });
    });

登录后复制

代码解析：

collect($deliveryNote-youjiankuohaophpcnline_items)：将原始数据转换为 Laravel Collection。
->groupBy(['type', 'size'])：这是第一层分组，它会创建一个 Collection，其键是 type，值是另一个 Collection，这个内部 Collection 的键是 size，值是最终的原始条目列表。
->map(function (Collection $typeGroups) { ... })：这个 map 方法遍历 groupBy 结果的最外层。$typeGroups 参数在每次迭代中，都代表了某个特定 type 下的所有 size 分组。例如，当 type 为 "NGR" 时，$typeGroups 将包含 "125-150" 和 "150-175" 两个键的 Collection。
return $typeGroups->map(function (Collection $sizeGroup) { ... })：在第一个 map 的回调中，我们对 $typeGroups（它本身也是一个 Collection）再次应用 map。这个内部的 map 遍历的是特定 type 下的 size 分组。$sizeGroup 参数在每次迭代中，都代表了某个特定 type 和 size 下的所有原始条目（例如，所有 type: "NGR", size: "125-150" 的条目）。
'type' => $sizeGroup->first()->type 和 'size' => $sizeGroup->first()->size：由于 $sizeGroup 中的所有条目都具有相同的 type 和 size，我们只需要从该分组的第一个元素中获取这些信息即可。first() 方法安全地返回 Collection 的第一个元素。
'amount' => $sizeGroup->sum('amount')：这是关键的聚合步骤。sum('amount') 方法会对 $sizeGroup 中所有条目的 amount 字段进行求和。Laravel Collection 的 sum 方法在遇到字符串数字时会自动尝试转换为数值进行计算。

执行上述代码后，$aggregatedData 将会得到我们期望的精简且聚合后的数据结构。

注意事项与最佳实践

数据类型转换： 原始数据中的 amount 字段是字符串类型（"30"）。Laravel Collection 的 sum() 方法通常能智能地将字符串数字转换为数值进行计算。但如果数据源不可靠或需要更严格的类型控制，可以在求和前显式转换，例如 (int)$item->amount 或 (float)$item->amount。
字段选择： 在构建返回数组时，只包含最终报告或显示所需的字段。这有助于保持数据简洁和相关性。
可读性： 链式调用是 Laravel Collection 的一个强大特性，它使得数据处理逻辑清晰且易于阅读。
性能考量： 对于非常庞大的数据集（例如，数百万条记录），在 PHP 层面进行如此深度的 Collection 操作可能会消耗较多内存和 CPU。在这种情况下，更高效的做法可能是在数据库层面利用 SQL 的 GROUP BY 和 SUM() 函数进行聚合，直接查询出聚合后的结果。
空数据处理： 确保 line_items 不为空，或者在处理前进行检查，以避免对空 Collection 调用方法可能导致的错误。不过，groupBy 和 map 对空 Collection 都有良好的兼容性，通常不会直接报错。

总结

通过本教程，我们学习了如何利用 Laravel Collection 的 groupBy 和嵌套 map 方法，优雅地处理多层分组后的数据聚合需求。这种方法不仅能够合并重复项，对特定字段进行求和，还能精简数据结构，使其更符合业务展示要求。掌握这些 Collection 操作技巧，将大大提升你在 Laravel 应用中处理复杂数据逻辑的能力。

以上就是Laravel Collection：多层分组后合并重复项并求和特定字段的教程的详细内容，更多请关注php中文网其它相关文章！