PHP array_merge 函数核心规则与避坑指南

结果与目标：理解数组合并的核心差异

array_merge() 是 PHP 中用于合并一个或多个数组的常用函数。许多开发者在使用时容易忽略其内部的键值处理逻辑，导致数据意外丢失或格式错乱。本文将明确两种主要场景下的行为准则：

1. 字符串键名冲突：后传入的数组值将直接覆盖先前的值。
2. 数值键名冲突：后传入数组的值不会覆盖，而是保持原值并按顺序追加到末尾，键名自动重新索引。

准备条件：参数类型严格限制

在 PHP >= 5.0 版本中，array_merge() 严格要求所有输入参数必须是 array 类型。如果传入 null 或其他标量类型，函数将抛出警告甚至错误。这在 foreach 循环或未预初始化的变量场景中极易引发 Bug。

第1步：字符串键名的覆盖行为演示

当多个数组包含相同的字符串键名时，后面的数组值会替换前面的值。若希望保留所有同名键的值，需使用 array_merge_recursive()。

示例代码：常规合并 vs 递归合并

以下代码展示了相同键名 'linux' 在两种不同合并方式下的输出差异：

<?php
// 定义两个包含相同字符串键名的数组
$book1 = array('linux' => 'linux服务器配置与管理', 'php' => 'PHP程序设计');
$book2 = array('linux' => '服务器配置与管理', 'jsp' => 'PHP'); 

// 1. 使用 array_merge：后者覆盖前者
$result_merge = array_merge($book1, $book2);
echo "Array Merge Result:\n";
print_r($result_merge);

// 2. 使用 array_merge_recursive：保留所有值形成子数组
echo "\nArray Merge Recursive Result:\n";
$result_recursive = array_merge_recursive($book1, $book2);
print_r($result_recursive);
?>

执行结果分析：

• array_merge：输出中 [linux] 的值为 服务器配置与管理，原值被覆盖。
• array_merge_recursive：[linux] 变成了一个子数组，包含前后两个版本的值，其他唯一键名正常保留。

第2步：数值键名的追加与重排行为

当数组使用数值索引（0, 1, 2...）时，array_merge() 的行为截然不同。它不会因为键名相同而覆盖，而是将所有值按顺序连接，并重置键名为从 0 开始的连续整数。

示例代码：数值键名合并

<?php
// 定义纯数值索引数组
$book1 = array('linux服务器配置与管理', 'PHP程序设计');
$book2 = array('服务器配置与管理', 'PHP'); 

$result = array_merge($book1, $book2);
print_r($result);
?>

执行结果分析：

输出数组将为 Array ( [0] => linux服务器配置与管理 [1] => PHP程序设计 [2] => 服务器配置与管理 [3] => PHP )。可以看到，第二个数组的两个元素分别占据了索引 2 和 3，原有索引结构被打断但数据完整保留。

第3步：解决非数组参数的类型错误

在实际开发中，变量可能因数据库查询失败或循环未执行而未被初始化为数组，导致 array_merge 报错。解决此问题的标准做法是确保变量始终为数组类型，或在合并前进行强制类型转换。

安全合并的最佳实践

假设变量 $data 可能为 null 或非数组：

<?php
$data = getData(); // 可能返回 null 或其他类型
$default = array('key' => 'value');

// 方法一：初始化习惯（推荐）
if (!is_array($data)) {
    $data = array();
}
$result = array_merge($default, $data);

// 方法二：强制类型转换（适用于已知结构兼容时）
$result = array_merge((array)$default, (array)$data);
?>

保持变量初始化的良好习惯，能有效避免此类隐性故障。以上就是 PHP array_merge 函数核心规则与避坑指南的详细内容，更多关于 PHP 数组操作的资料请关注本站其它相关文章！