如何在 PHP 中按名称合并数组并汇总数值字段

本文介绍如何在 php 中根据指定键（如 name）对关联数组进行分组，并对数值字段（如 coef）执行求和操作，同时保留其他字段（如 visitcount）的原始值。

处理数组数据时，一个常见的需求是：如何把那些具有相同标识的记录合并起来，同时对某些数值进行汇总？比如，有一组用户访问记录，需要把同一个用户的“系数”加起来，但又要保留他第一次出现时的“访问次数”。

这种场景在报表生成、数据清洗中经常遇到。下面分享一个既简洁又健壮的实现方案，它足够灵活，能轻松应对各种类似的聚合需求。

✅ 核心思路

关键在于利用名称作为临时数组的键。遍历原始数组时，我们建立一个映射：

• 如果这个名称是第一次出现，那就以它为键，完整地创建一条新记录。
• 如果这个名称已经存在了，那就只对需要累加的字段（比如‘coef’）做加法，其他字段则保持原样（默认保留首次值，当然你也可以按需调整）。

这样一来，逻辑清晰，性能也不错。

? 示例代码（推荐写法）

$params = [
    ["name" => "Robert", "visitCount" => 2, "coef" => "5.50"],
    ["name" => "Anna",   "visitCount" => 1, "coef" => "3.58"],
    ["name" => "Joe",    "visitCount" => 1, "coef" => "8.00"],
    ["name" => "Robert", "visitCount" => 2, "coef" => "1.50"],
];
$output = [];
foreach ($params as $item) {
    $name = $item['name'];
    if (!isset($output[$name])) {
        // 首次出现：完整初始化（注意 coef 转为 float 保障精度）
        $output[$name] = [
            'name'       => $name,
            'visitCount' => $item['visitCount'],
            'coef'       => (float)$item['coef']
        ];
    } else {
        // 再次出现：仅累加 coef（自动类型转换避免字符串拼接）
        $output[$name]['coef'] += (float)$item['coef'];
    }
}
// 转为索引数组（去除 name 键，符合预期输出格式）
$result = array_values($output);
print_r($result);

⚠️ 注意事项

代码虽短，但有几个细节必须留意，否则很容易掉进坑里：

• 数值精度是头等大事：如果 coef 字段存的是字符串（比如 "5.50"），务必用 (float) 显式转换。否则，PHP 的 + 运算符可能会进行字符串连接，或者产生意想不到的类型转换，导致结果出错。
• 字段保留策略可以自定义：上面的例子中，visitCount 保留了第一次出现的值。如果你需要取最大值、最小值或者计算平均值，完全可以在 else 分支里添加相应逻辑。比如，用 max() 函数来保留最大的访问次数。
• 别忘了空数组防护：在生产环境中，稳妥起见，最好在遍历前加上 is_array($params) && !empty($params) 这样的判断，避免无效输入导致错误。
• 性能考量：这个算法的时间复杂度是 O(n)，处理万级别以下的数据量游刃有余。如果数据量极大，可以考虑使用 array_reduce 函数，或者干脆将聚合逻辑下沉到数据库层面去执行，效率更高。

✅ 输出结果

Array
(
    [0] => Array
        (
            [name] => Robert
            [visitCount] => 2
            [coef] => 7
        )
    [1] => Array
        (
            [name] => Anna
            [visitCount] => 1
            [coef] => 3.58
        )
    [2] => Array
        (
            [name] => Joe
            [visitCount] => 1
            [coef] => 8
        )
)

? 提示：你可能会注意到，Robert 的 coef 输出是 7，而不是 “7.00”。这是 PHP 默认显示浮点数的方式。如果需要固定显示两位小数，可以使用 number_format($val, 2, '.', '') 函数在赋值前进行格式化。

掌握了这个核心方法，你就拥有了处理数组聚合的“瑞士军刀”。无论是多字段求和、计数统计，还是复杂的数据去重与归并，都可以在这个框架上灵活扩展，轻松应对。

立即学习“PHP免费学习笔记（深入）”；