php array_merge() 数组合并函数

封面图 • 2025-11-03 • PHP

在 PHP 中，`array_merge()` 是一个非常常用的函数，用于**合并一个或多个数组**。它将多个数组的元素合并成一个新的数组。

---

## ✅ 语法：

```php
array_merge(array1, array2, array3...)
```

- `array1`, `array2`, `array3` 等是你要合并的数组。
- 如果参数中没有数组，则返回空数组。
- 如果键名是整数（索引），则会重新索引；如果是字符串键名，则保留原键名，并且后面的数组如果出现相同的键名，会覆盖前面的值。

---

## 🔍 示例 1：合并两个数组

```php
$array1 = [1, 2, 3];
$array2 = [4, 5, 6];

$result = array_merge($array1, $array2);

print_r($result);
```

**输出：**

```
Array
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
    [5] => 6
)
```

---

## 🔍 示例 2：带有字符串键名的数组

```php
$array1 = ['a' => 1, 'b' => 2];
$array2 = ['b' => 3, 'c' => 4];

$result = array_merge($array1, $array2);

print_r($result);
```

**输出：**

```
Array
(
    [a] => 1
    [b] => 3
    [c] => 4
)
```

> 注意：`$array2` 的 `'b'` 键覆盖了 `$array1` 的 `'b'`。

---

## 🔍 示例 3：混合索引和关联键名

```php
$array1 = [1, 2, 'a' => 3];
$array2 = [3, 4, 'a' => 5];

$result = array_merge($array1, $array2);

print_r($result);
```

**输出：**

```
Array
(
    [0] => 1
    [1] => 2
    [a] => 5
    [2] => 3
    [3] => 4
)
```

> 注意：索引部分被重新编号，而关联键名 `'a'` 被覆盖。

---

## ⚠️ 注意事项：

- **如果输入不是数组**，`array_merge()` 会报错。
- **不要用 `array_merge()` 合并多维数组**，它不会递归合并，只会“平铺”。
- 如果你想**递归合并数组**（如合并嵌套数组），可以使用 `array_merge_recursive()`。

---

## 🔄 `array_merge()` 和 `array_merge_recursive()` 的区别：

| 函数 | 是否递归合并 |
|------|----------------|
| `array_merge()` | ❌ 不递归 |
| `array_merge_recursive()` | ✅ 递归 |

---

## ✅ 总结：

- `array_merge()` 是 PHP 中最常用的数组合并函数。
- 它适用于大多数场景，尤其是当你需要简单地将多个数组合并为一个时。
- 如果你需要处理多维数组，考虑使用 `array_merge_recursive()`。

---

如果你有具体的使用场景或问题，欢迎继续提问！