本文介绍一种基于“控制断点”（control break）逻辑的 php 数组分组方法：当指定键（如 `grouped_by`）的值发生**连续性变化**时，自动创建新分组并生成带序号后缀的唯一键（如 `1.1`、`4.1`、`1.2`），而非简单地按键值聚合。
在实际业务场景中（如工时报告、日志序列分析或时间线渲染），我们常需保留原始数据的物理顺序，并对相邻相同键值的元素进行“段式分组”——即每当目标键（如 grouped_by）的值发生变化时，就开启一个新分组。这与传统 array_reduce 或 foreach + $result[$key][] = $item 的哈希式聚合有本质区别：后者将所有相同键的元素归入同一桶，而前者强调连续块识别（contiguous block detection）。
实现该逻辑的核心思想是模拟“控制断点处理”（常见于 COBOL 或报表引擎）：遍历数组时持续跟踪上一个元素的分组键值；一旦发现当前键值 ≠ 上一个键值，即触发“断点”，为该键值对应的分组计数器递增，再以此生成形如 "{key}.{counter}" 的唯一分组键。
以下是完整、健壮的实现代码：
function groupBySequentialKey(array $items, string $key): array
{
if (empty($items)) {
return [];
}
$result = [];
$counts = []; // 记录每个键值当前已出现的连续段序号
$prevValue = null;
foreach ($items as $item) {
$currentValue = $item[$key] ?? null;
// 检测控制断点：值变化即开启新段
if ($currentValue !== $prevValue) {
$counts[$currentValue] = ($counts[$currentValue] ?? 0) + 1;
}
$groupKey = $currentValue . '.' . $counts[$currentValue];
$result[$groupKey][] = $item;
$prevValue = $currentValue;
}
return $result;
}
// 使用示例
$report_items = [
['id' => 972, 'user_id' => 2, 'user_field_48' => 1, 'project' => '100 — NLO', 'duration' => '1:00', 'grouped_by' => 1],
['id' => 644, 'user_id' => 2, 'user_field_48' => 4, 'project' => '123 — QHV', 'duration' => '15:00', 'grouped_by' => 4],
['id' => 631, 'user_id' => 2, 'user_field_48' => 4, 'project' => '', 'duration' => '-5:00', 'grouped_by' => 4],
['id' => 630, 'user_id' => 2, 'user_field_48' => 1, 'project' => '', 'duration' => '22:00', 'grouped_by' => 1],
['id' => 971, 'user_id' => 2, 'user_field_48' => 1, 'project' => '100 — NLO', 'duration' => '1:00', 'grouped_by' => 1],
['id' => 973, 'user_id' => 2, 'user_field_48' => 1, 'project' => '100 — NLO', 'duration' => '1:00', 'grouped_by' => 1],
['id' => 974, 'user_id' => 2, 'user_field_48' => 1, 'project' => '100 — NLO', 'duration' => '1:00', 'grouped_by' => 1],
];
$grouped = groupBySequentialKey($report_items, 'grouped_by');
print_r($grouped);✅ 输出效果（符合预期）：
- 1.1 → [972]（首个 grouped_by=1 段）
- 4.1 → [644, 631]（首个 grouped_by=4 段）
- 1.2 → [630, 971, 973, 974]（第二个 grouped_by=1 连续段）
? 关键注意事项：
- 严格依赖顺序：此方法仅对输入数组的原始索引顺序敏感，若需先排序再分组，请预先调用 usort()。
- 键值类型兼容：支持字符串、整数、布尔值等可拼接类型；若 $key 不存在，会设为 null，建议生产环境增加 isset($item[$key]) 校验并抛出异常。
- 性能友好：单次遍历 O(n) 时间复杂度，空间复杂度 O(n)，无递归或嵌套循环。
- 可扩展性：函数封装后便于复用；如需自定义分隔符（如 1_1），只需修改 $groupKey 构建逻辑。
? 进阶提示：若需进一步按段内字段（如 project）二次分组，可在每个 $result[$groupKey] 子数组上再次调用本函数，形成多级顺序分组结构。这种模式特别适合构建可折叠的层级报表或时间轴视图。
