异常教程

PHP array_merge() 函数（长文讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

什么是 PHP array_merge() 函数？

在 PHP 开发中，数组操作是日常编程的核心任务之一。无论是处理用户输入、合并配置文件，还是整合多数据源，开发者常常需要将多个数组合并成一个统一的结构。此时，array_merge() 函数便成为了一个不可或缺的工具。它能够将两个或多个数组合并为一个新数组，同时处理不同类型的键名冲突，极大简化了数组操作的复杂度。

函数基础：语法与基本用法

核心语法

array_merge() 函数的语法非常直观：

array array_merge(array $array1, array $array2, ...): array

该函数接受一个或多个数组作为参数，返回合并后的新数组。原始数组不会被修改，这与 array_push() 等原地操作函数有本质区别。

索引数组的合并示例

$array1 = [1, 2, 3];
$array2 = [4, 5, 6];
$merged = array_merge($array1, $array2);
// 输出：[1, 2, 3, 4, 5, 6]

通过这个例子可以看到，当合并索引数组时，元素会按顺序追加，索引自动递增。就像把两摞书合并到一个书架上，后面的书会排在原有书籍之后。

关联数组的合并规则

$arrayA = ['name' => 'Alice', 'age' => 30];
$arrayB = ['age' => 25, 'city' => 'Shanghai'];
$merged = array_merge($arrayA, $arrayB);
// 输出：['name' => 'Alice', 'age' => 25, 'city' => 'Shanghai']

这里的关键是：当遇到相同键名时，后面的数组值会覆盖前面的值。这类似于整理两个文件夹时，后面的文件会替换同名的旧文件。

进阶用法：合并规则与特殊场景

1. 处理混合类型的数组

$array1 = [10, 20, 'key' => 'value'];
$array2 = ['key' => 'new_value', 30];
$merged = array_merge($array1, $array2);
// 输出：[10, 20, 'key' => 'new_value', 30]

合并过程中，索引键和关联键会被分别处理。索引键（整数键）按顺序追加，而字符串键名则遵循覆盖规则。

2. 合并空数组的特殊性

$array = array_merge([], [1,2,3]); // 输出 [1,2,3]
$array = array_merge([1,2,3], []); // 输出 [1,2,3]

空数组不会影响合并结果，但作为参数传递时需要注意优先级。

3. 多维数组的合并

$array1 = [['a', 'b'], ['c']];
$array2 = [['d'], ['e', 'f']];
$merged = array_merge($array1, $array2);
// 输出：[ ['a','b'], ['c'], ['d'], ['e','f'] ]

多维数组的合并遵循同样的规则，子数组会被整体视为单个元素进行追加。

实战案例：常见开发场景应用

场景1：合并用户配置与默认配置

// 默认配置
$defaults = [
    'theme' => 'light',
    'timeout' => 30,
    'notifications' => true
];

// 用户自定义配置
$user_config = [
    'theme' => 'dark',
    'timeout' => 60
];

// 合并配置
$final_config = array_merge($defaults, $user_config);
// 结果：theme和timeout被覆盖，其他保持默认

场景2：处理表单数据与默认值

// 表单提交数据
$post_data = $_POST ?? [];

// 默认值设置
$defaults = [
    'email' => 'guest@example.com',
    'subscribe' => false
];

// 合并并填充默认值
$clean_data = array_merge($defaults, $post_data);

场景3：合并购物车与收藏夹数据

$cart = [
    ['id' => 101, 'quantity' => 2],
    ['id' => 102, 'quantity' => 1]
];

$wishlist = [
    ['id' => 103, 'quantity' => 0],
    ['id' => 101, 'quantity' => 3]
];

// 合并时保留最新数量
$merged_items = array_merge($cart, $wishlist);
// 注意：相同id的条目会被视为不同元素

深度解析：合并过程的底层逻辑

键名冲突的处理机制

当两个数组存在相同键名时：

  • 数值键：后面的数组值会覆盖前面的
  • 字符串键：后面的数组值会覆盖前面的
  • 混合键类型：数值键会被视为字符串键进行处理

这个机制的设计，使得 array_merge() 在合并配置数组时特别实用，可以方便地覆盖默认值。

索引重置的注意事项

$array = array_merge(['a'], ['b']);
// 输出：[0 => 'a', 1 => 'b']

当合并索引数组时，所有元素会被重新编号为连续的整数索引，这与 array_replace() 的行为形成对比。

与 array_merge_recursive 的区别

当需要合并多维数组并保留嵌套结构时，应使用 array_merge_recursive()：

$array1 = ['a' => [1,2]];
$array2 = ['a' => [3,4]];
// array_merge() 结果：['a' => [3,4]]
// array_merge_recursive() 结果：['a' => [1,2,3,4]]

常见问题与解决方案

问题1：如何避免键名覆盖？

当需要保留所有元素时，可以先重置数组键名：

$array1 = ['a' => 1];
$array2 = ['a' => 2];
$merged = array_merge($array1, array_values($array2));
// 输出：['a' => 1, 0 => 2]

问题2：合并多个数组的最优方式

$merged = array_merge($array1, $array2, $array3, $array4);
// 或使用可变参数
function merge_all(...$arrays) {
    return array_merge(...$arrays);
}

问题3：如何合并带有对象的数组？

PHP 会将对象转换为数组，但需确保对象实现了 ArrayAccess 接口：

class MyObject implements ArrayAccess { ... }
$array = [new MyObject()];
$merged = array_merge($array, [1,2]); // 正常合并

性能优化与最佳实践

合并大数组的注意事项

当处理包含数千元素的数组时：

// 避免重复合并
$temp = $array1;
$temp += $array2; // 使用短语法替代
$final = array_merge($temp, $array3);

使用替代函数的场景

  • + 运算符：仅合并关联数组，且保留第一个数组的值
  • array_replace()：覆盖同名键的值，保留原始键类型
  • array_merge_recursive()：处理多维数组嵌套合并

错误处理建议

if (!is_array($array1) || !is_array($array2)) {
    throw new InvalidArgumentException("参数必须为数组");
}
$merged = array_merge($array1, $array2);

总结：array_merge() 的核心价值

通过本文的深入解析，我们可以看到 PHP array_merge() 函数在数组操作中的核心地位：

  • 基础合并：快速整合多个数据源
  • 配置管理：实现灵活的默认值覆盖机制
  • 结构重组：通过键名规则控制合并结果

对于开发者而言，掌握 array_merge() 不仅能提升代码效率，更能培养对数组结构化思维的理解。建议在开发过程中：

  1. 始终验证输入数据类型
  2. 明确键名冲突的处理策略
  3. 结合其他函数构建更复杂的合并逻辑

通过持续实践和案例分析，开发者将能够熟练运用这一基础但强大的工具，解决各类数组合并场景中的实际问题。

最新发布

查看更多文章