PHP循环高效聚合数据，按键生成嵌套数组结构

本教程旨在解决如何将扁平化的数据库查询结果，通过循环处理，高效地转换为按特定键（如日期）分组的嵌套数组结构。文章将详细阐述一种利用关联数组特性，在迭代过程中动态构建并聚合数据的策略，从而实现将多个相关条目（如时间段）归集到同一父级（如某一天）下，生成清晰、易于管理的数据结构。

数据聚合需求分析

在实际的Web开发中，我们经常需要从数据库中获取数据，并将其整理成更符合前端展示或后端逻辑处理的复杂结构。一个常见的场景是，数据库中的设置（settings）表可能包含多条记录，每条记录代表一个时间段，并且不同的时间段可能属于同一天。例如，星期一可能有上午和下午两个独立的时间段设置。

假设我们从数据库中获取到 $settings 变量，其结构可能如下：

// 假设 $settings 是从数据库查询到的对象数组
// 示例数据：
// [
//   (object)['day' => 1, 'start' => '08:00', 'end' => '17:00'],
//   (object)['day' => 2, 'start' => '08:00', 'end' => '12:00'],
//   (object)['day' => 2, 'start' => '14:00', 'end' => '17:00']
// ]

我们希望将这些扁平化的数据转换成按天分组的嵌套结构，具体目标结构如下：

$items = [
  // 第1天
  [
    'day' => 1,
    'periods' => [
      ['start' => '08:00', 'end' => '17:00']
    ]
  ],
  // 第2天
  [
    'day' => 2,
    'periods' => [
      ['start' => '08:00', 'end' => '12:00'],
      ['start' => '14:00', 'end' => '17:00']
    ]
  ]
];

注意到这里，day为2的记录，其periods键下包含了两个时间段的数组。

初始尝试与存在的问题

如果仅仅使用简单的循环和 array_push，我们可能会得到一个不符合预期的结果。例如：

$items = [];
foreach($settings as $setting){
   $items[] = [
     'day' => $setting->day,
     'periods' => [
       'start' => $setting->start,
       'end' => $setting->end
      ]
   ];
}

上述代码将产生以下结果：

$items = [
  [
    'day' => 1,
    'periods' => ['start' => '08:00', 'end' => '17:00']
  ],
  [
    'day' => 2,
    'periods' => ['start' => '08:00', 'end' => '12:00']
  ],
  [
    'day' => 2,
    'periods' => ['start' => '14:00', 'end' => '17:00']
  ]
];

这种结果是每个时间段都作为一个独立的记录存在，并没有将同一天的多个时间段聚合在一起，这与我们的目标结构不符。

高效的解决方案：利用关联数组特性

为了实现按天分组并聚合时间段的目标，我们可以利用PHP关联数组的特性，将 $setting->day 作为主数组的键。这样，我们可以在循环中直接通过天数来访问或创建对应的数组元素，并向其 periods 数组中添加新的时间段。

以下是实现此目标的优化代码：

$items = []; // 初始化一个空数组来存储结果

foreach ($settings as $setting) {
    // 检查当前天数是否已作为键存在于 $items 数组中
    if (empty($items[$setting->day])) {
        // 如果不存在，则为这一天创建一个新的条目
        // 'day' 键可以存储天数本身，'periods' 初始化为空数组
        $items[$setting->day] = [
            'day' => $setting->day,
            'periods' => [],
        ];
    }

    // 将当前设置的时间段添加到对应天的 'periods' 数组中
    $items[$setting->day]['periods'][] = [
        'start' => $setting->start,
        'end' => $setting->end
    ];
}

解决方案详解

1. 初始化 $items 数组：在循环开始前，声明一个空的 $items 数组，用于存放最终聚合后的数据。
2. 遍历 $settings 数据：对从数据库获取的每一条设置记录进行迭代。
3. 检查天数键是否存在：在每次迭代中，我们使用 empty($items[$setting->day]) 来判断 $items 数组中是否已经存在以当前 day 作为键的元素。
   • empty() 函数在这里非常有用，它不仅检查变量是否未设置，也检查其值是否为“空”（例如 null, 0, false, 空字符串，空数组）。这意味着如果 $items[$setting->day] 尚未被定义，或者其值为“空”，条件都将为真。
4. 创建新天数条目：如果 $items[$setting->day] 为空（即这是我们第一次遇到这一天的记录），则为这一天创建一个新的数组结构。这个结构包含 'day' 键（存储天数值）和 'periods' 键（初始化为一个空数组，用于后续添加时间段）。
5. 添加时间段：无论 $items[$setting->day] 是刚刚创建的，还是之前就已经存在的，我们都直接将当前 $setting 中的 start 和 end 时间作为一个新的关联数组，追加到 $items[$setting->day]['periods'] 数组中。[] 语法确保了时间段被作为新元素添加到 periods 数组的末尾。

最终结果示例

执行上述代码后，$items 数组将呈现以下结构：

$items = [
  1 => [ // 键为天数 1
    'day' => 1,
    'periods' => [
      ['start' => '08:00', 'end' => '17:00']
    ]
  ],
  2 => [ // 键为天数 2
    'day' => 2,
    'periods' => [
      ['start' => '08:00', 'end' => '12:00'],
      ['start' => '14:00', 'end' => '17:00']
    ]
  ]
];

这个结果是一个关联数组，其键是天数，值是包含该天所有时间段的数组。这种结构不仅达到了按天分组的目的，还允许通过天数直接访问对应的数据（例如 $items[2]），提高了数据检索的效率。如果最终需要一个非关联的索引数组，可以在处理完成后调用 array_values($items)。

总结

通过在循环中巧妙地利用关联数组的键来动态构建和聚合数据，我们能够高效地将扁平化的数据结构转换为复杂的嵌套结构。这种方法不仅代码简洁，逻辑清晰，而且在处理大量数据时表现出良好的性能，是PHP开发中处理类似数据聚合需求的推荐实践。此模式可广泛应用于按用户ID、产品类别等任何需要分组的场景。