PHP 数组数据添加深度解析：从基础到高级的高效实践指南249

在 PHP 编程中，数组（Array）无疑是最常用也是功能最强大的数据结构之一。它允许我们存储和组织大量相关数据，无论是简单的列表、复杂的配置信息还是数据库查询结果，数组都扮演着核心角色。掌握如何高效、灵活地向数组中添加数据，是每一位 PHP 开发者必备的技能。本文将作为一份深度指南，详细介绍 PHP 中各种添加数组数据的方法，从最基础的语法到高级函数的运用，并探讨其背后的原理、性能考量及最佳实践。

通过本文，您将学习到：
使用方括号 `[]` 语法添加数据。
使用 `array_push()` 函数批量添加数据。
使用 `array_merge()` 函数合并数组。
使用 `+` 运算符（联合运算符）合并数组。
使用 `array_splice()` 函数在特定位置插入数据。
如何向多维数组中添加数据。
不同方法的性能对比与适用场景。
处理键冲突、内存管理及最佳实践。

一、基础添加方法：简洁与高效

PHP 提供了几种非常直观的方法来向数组中添加数据，其中最常用的是方括号语法和 `array_push()` 函数。

1.1 使用方括号 `[]` 语法

这是 PHP 中向数组添加数据最常见、最简洁的方式。它根据数组的类型（索引数组或关联数组）表现出不同的行为。

1.1.1 向索引数组末尾添加

当数组是索引数组（即其键是连续的数字，从 0 开始）时，使用空的方括号 `[]` 会将新数据添加到数组的末尾，并自动分配一个比当前最大整数键大 1 的新键。
<?php
$fruits = ['苹果', '香蕉'];
$fruits[] = '橙子'; // 添加到末尾，键为 2
$fruits[] = '葡萄'; // 添加到末尾，键为 3
print_r($fruits);
/*
Array
(
[0] => 苹果
[1] => 香蕉
[2] => 橙子
[3] => 葡萄
)
*/
$numbers = [1, 2, 3];
unset($numbers[1]); // 删除键为 1 的元素
$numbers[] = 4; // 此时最大键为 2，所以新键为 3
print_r($numbers);
/*
Array
(
[0] => 1
[2] => 3
[3] => 4
)
*/
// 注意：即使中间有键被删除，`[]` 也会找到当前最大的数字键并在此基础上递增。
// 如果数组中完全没有数字键，则从 0 开始。
?>

1.1.2 向关联数组添加或更新

对于关联数组，您可以指定一个键来添加数据。如果该键已经存在，则会更新其对应的值；如果键不存在，则会添加新的键值对。
<?php
$user = [
'name' => '张三',
'age' => 30
];
$user['email'] = 'zhangsan@'; // 添加新键值对
$user['age'] = 31; // 更新现有键的值
print_r($user);
/*
Array
(
[name] => 张三
[age] => 31
[email] => zhangsan@
)
*/
?>

优点：

简洁直观： 语法简单，易于理解和编写。
性能高效： 作为语言结构，其内部实现通常比函数调用更快，尤其是在大量循环中添加单个元素时。
灵活性： 既能用于索引数组，也能用于关联数组。

1.2 使用 `array_push()` 函数

`array_push()` 函数用于将一个或多个元素压入（添加到）数组的末尾。它接受数组作为第一个参数，以及要添加的元素作为后续参数。
<?php
$colors = ['红色', '绿色'];
array_push($colors, '蓝色', '黄色'); // 添加多个元素到末尾
print_r($colors);
/*
Array
(
[0] => 红色
[1] => 绿色
[2] => 蓝色
[3] => 黄色
)
*/
$products = ['Laptop'];
array_push($products, 'Mouse'); // 添加单个元素
print_r($products);
/*
Array
(
[0] => Laptop
[1] => Mouse
)
*/
?>

注意事项：

`array_push()` 函数将把传入的数组视为一个栈，并把新的元素压入栈顶。这意味着它主要用于模拟索引数组的末尾添加行为。
它会修改原始数组，而不是返回一个新数组。
如果第一个参数不是数组，`array_push()` 会发出警告。
对于只添加一个元素的情况，`$arr[] = $value;` 的性能通常略优于 `array_push($arr, $value);`，因为后者涉及到函数调用的开销。但这种差异在大多数实际应用中可以忽略不计。

二、批量添加与合并数组：更复杂的场景

当您需要将一个或多个数组的数据批量添加到另一个数组中时，PHP 提供了 `array_merge()` 函数和 `+` 运算符。

2.1 使用 `array_merge()` 函数

`array_merge()` 函数用于将一个或多个数组合并起来。它的行为会根据数组中键的类型（数字键或字符串键）而有所不同。
<?php
$array1 = [1, 2, 3];
$array2 = [4, 5, 6];
$mergedArray1 = array_merge($array1, $array2);
print_r($mergedArray1);
/*
Array
(
[0] => 1
[1] => 2
[2] => 3
[3] => 4
[4] => 5
[5] => 6
)
*/
$userProfile = ['name' => 'Alice', 'age' => 25];
$userContact = ['email' => 'alice@', 'phone' => '123-456-7890'];
$mergedUser = array_merge($userProfile, $userContact);
print_r($mergedUser);
/*
Array
(
[name] => Alice
[age] => 25
[email] => alice@
[phone] => 123-456-7890
)
*/
?>

键冲突处理：
数字键： 如果两个数组都包含数字键，`array_merge()` 会重新索引合并后的数组，从 0 开始。
字符串键： 如果两个数组包含相同的字符串键，后一个数组的值会覆盖前一个数组中对应键的值。


<?php
// 数字键冲突：重新索引
$arrA = [0 => 'a', 1 => 'b'];
$arrB = [0 => 'c', 1 => 'd'];
$mergedNumeric = array_merge($arrA, $arrB);
print_r($mergedNumeric);
/*
Array
(
[0] => a
[1] => b
[2] => c
[3] => d
)
*/
// 字符串键冲突：后值覆盖前值
$configDefault = ['host' => 'localhost', 'port' => 80];
$configUser = ['port' => 8080, 'user' => 'admin'];
$finalConfig = array_merge($configDefault, $configUser);
print_r($finalConfig);
/*
Array
(
[host] => localhost
[port] => 8080 // 80 被 8080 覆盖
[user] => admin
)
*/
?>

优点：

功能强大： 能够合并任意数量的数组。
处理灵活： 自动处理数字键的重新索引和字符串键的覆盖。

注意事项：

`array_merge()` 会返回一个新的数组，而不是修改原数组。
如果只传入一个数组，`array_merge()` 会对该数组进行重新索引（如果它包含非连续的数字键）。

2.2 使用 `+` 运算符（联合运算符）

PHP 中的 `+` 运算符在用于数组时，被称为“联合”运算符。它的行为与 `array_merge()` 有显著不同，主要体现在键冲突的处理上。
<?php
$base = ['name' => 'Bob', 'age' => 40];
$new = ['email' => 'bob@', 'age' => 41];
$result = $base + $new; // $base 在左侧
print_r($result);
/*
Array
(
[name] => Bob
[age] => 40 // $base 中的 'age' 保持不变，未被覆盖
[email] => bob@
)
*/
$arrC = [0 => 'itemA', 1 => 'itemB'];
$arrD = [0 => 'itemC', 2 => 'itemD'];
$mergedUnion = $arrC + $arrD;
print_r($mergedUnion);
/*
Array
(
[0] => itemA // $arrC 中的 0 键保持不变
[1] => itemB
[2] => itemD // $arrD 中的 2 键被添加
)
*/
?>

键冲突处理：
无论是数字键还是字符串键，如果左侧数组已经存在某个键，那么右侧数组中具有相同键的元素将不会被添加或覆盖。
只有当左侧数组中不存在某个键时，右侧数组中对应键值对才会被添加。

优点：

保留优先： 当您希望保留原始数组（左侧）的值，并仅添加新键时，`+` 运算符非常有用。

注意事项：

`+` 运算符也会返回一个新的数组，而不是修改原数组。
对于索引数组，`+` 运算符可能不会像 `array_merge()` 那样重新索引，这可能导致非连续的数字键。
它的行为更像“添加不存在的键”，而不是“合并并覆盖”。

三、在特定位置添加数据：精细控制

有时您不仅需要添加数据，还需要控制数据在数组中的精确位置。`array_splice()` 函数可以满足这种需求。

3.1 使用 `array_splice()` 函数

`array_splice()` 函数非常强大，它可以从数组中删除元素，同时在删除的位置插入新元素。这使得它成为在任意位置添加数据的理想选择。
<?php
$myArray = ['a', 'b', 'd', 'e'];
// 在索引 2 的位置插入 'c'
// array_splice($input, $offset, $length, $replacement)
// $offset = 2: 从索引 2 开始
// $length = 0: 不删除任何元素
// $replacement = ['c']: 插入 'c'
array_splice($myArray, 2, 0, ['c']);
print_r($myArray);
/*
Array
(
[0] => a
[1] => b
[2] => c // 'c' 被插入到 'd' 之前
[3] => d
[4] => e
)
*/
$data = ['item1', 'item2', 'item5', 'item6'];
// 在索引 2 的位置插入多个元素
array_splice($data, 2, 0, ['item3', 'item4']);
print_r($data);
/*
Array
(
[0] => item1
[1] => item2
[2] => item3
[3] => item4
[4] => item5
[5] => item6
)
*/
?>

参数说明：

`$input`：要操作的数组。
`$offset`：开始插入/删除的位置（索引）。负数表示从数组末尾开始计数。
`$length`：要删除的元素数量。设置为 `0` 表示不删除任何元素，只进行插入操作。
`$replacement`：要插入的元素（可以是一个数组，也可以是单个值）。如果省略此参数，则只删除元素。

注意事项：

`array_splice()` 函数会直接修改原始数组，并返回一个包含被移除元素的数组（如果 `$length` 大于 0）。
对于关联数组，`array_splice()` 也会重新索引数字键，并且可能会打乱关联键的顺序（虽然通常不建议在关联数组中使用它进行位置插入，因为它会改变数组结构）。

四、添加到多维数组：嵌套结构的处理

PHP 数组可以是多维的，即数组的元素本身也是数组。向多维数组中添加数据，需要通过层层索引来定位。
<?php
$users = [
'admin' => [
'name' => '管理员',
'roles' => ['superuser', 'editor']
],
'guest' => [
'name' => '访客',
'roles' => ['viewer']
]
];
// 1. 向 'admin' 用户的 'roles' 数组中添加新的角色
$users['admin']['roles'][] = 'moderator';
// 2. 添加一个新的用户
$users['editor'] = [
'name' => '编辑',
'roles' => ['editor']
];
// 3. 向新用户的 'roles' 数组中添加一个角色
$users['editor']['roles'][] = 'contributor';
print_r($users);
/*
Array
(
[admin] => Array
(
[name] => 管理员
[roles] => Array
(
[0] => superuser
[1] => editor
[2] => moderator // 新添加的角色
)
)
[guest] => Array
(
[name] => 访客
[roles] => Array
(
[0] => viewer
)
)
[editor] => Array // 新添加的用户
(
[name] => 编辑
[roles] => Array
(
[0] => editor
[1] => contributor // 新添加的角色
)
)
)
*/
?>

要点：

通过连续的方括号 `[]` 来访问多维数组的内部元素。
一旦定位到要修改的子数组，就可以使用之前介绍的任何方法（如 `[]`、`array_push()`、`array_merge()` 等）来添加数据。

五、性能与最佳实践：选择合适的工具

不同的添加数据方法在性能、内存使用和代码可读性方面存在差异。理解这些差异有助于您做出明智的选择。

5.1 `[]` vs `array_push()`

性能： 对于添加单个元素，`$arr[] = $value;` 通常比 `array_push($arr, $value);` 略快，因为它是一个语言结构，避免了函数调用的开销。但这种差异在大多数非性能敏感的应用中可以忽略不计。
批量添加： `array_push()` 允许您一次性添加多个元素，在代码上可能更简洁，例如 `array_push($arr, $val1, $val2, $val3);`。而 `[]` 则需要多次操作。
可读性： 两者都非常清晰。`[]` 适用于快速添加，`array_push()` 则强调“压入”一个或多个元素。
推荐：

添加单个元素：优先使用 `$arr[] = $value;`。
批量添加多个元素：`array_push()` 更简洁。

5.2 `array_merge()` vs `+` 运算符

这两者的主要区别在于对键冲突的处理方式：


特性
`array_merge()`
`+` 运算符




数字键处理
重新索引，从 0 开始连续
不重新索引，只添加不存在的数字键


字符串键冲突
后一个数组的值覆盖前一个数组的值
保留左侧数组的值，右侧数组中相同键的值被忽略


返回值
总是返回一个新数组
总是返回一个新数组


适用场景


需要合并多个列表并重新索引
希望用新数据覆盖旧配置




希望在不覆盖现有数据的情况下添加新配置项
保留左侧数组的键值优先级

性能考量：

`array_merge()` 和 `+` 运算符都会创建并返回一个新的数组，这意味着它们会占用额外的内存空间。对于非常大的数组，这可能是一个需要考虑的因素。
通常情况下，`+` 运算符的性能可能略优于 `array_merge()`，尤其是在键冲突较多的关联数组合并时，因为它不需要进行覆盖操作，只需检查键是否存在。但在大多数实际应用中，这种性能差异并不显著。

5.3 内存管理

当处理大型数组时，内存使用是一个重要的考虑因素。像 `array_merge()` 这样的函数会创建原数组的副本，这可能导致内存翻倍。如果您需要频繁地修改大数组，并希望减少内存开销，可以考虑：
直接修改： 使用 `[]` 或 `array_push()` 直接修改原数组。
迭代添加： 避免一次性合并两个巨大的数组，可以考虑遍历其中一个数组，逐个添加到另一个数组中（但要权衡循环开销和函数调用开销）。
生成器（Generator）： 在某些场景下，如果只是需要迭代处理数据而不是一次性加载到内存中，PHP 的生成器可以有效减少内存占用。

5.4 可读性与维护性

选择最能表达您意图的方法，而不是仅仅追求微小的性能提升。清晰的代码比微小的性能优化更重要。

需要向末尾添加：`[]` 或 `array_push()`。
需要合并两个数组，且希望新数组覆盖旧数组的同名键：`array_merge()`。
需要合并两个数组，且希望保留旧数组的同名键：`+` 运算符。
需要在特定位置插入：`array_splice()`。

六、常见问题与注意事项

6.1 键的类型

PHP 数组的键可以是整数或字符串。在使用添加方法时，务必注意键的类型以及它们如何被处理，特别是当您希望控制数组的结构时。例如，`array_push()` 总是添加数字键，即使原数组是关联数组。
<?php
$assocArray = ['name' => 'John', 'age' => 30];
array_push($assocArray, 'new_value'); // 'new_value' 将被添加到数字键 0
print_r($assocArray);
/*
Array
(
[name] => John
[age] => 30
[0] => new_value
)
*/
?>

这通常不是期望的行为，因此对于关联数组，更推荐使用 `$arr['new_key'] = $value;`。

6.2 添加非标量数据

PHP 数组的元素不仅可以是字符串或数字，还可以是其他数组、对象、资源等。所有上述添加方法都支持添加非标量数据。
<?php
class User {}
$data = [];
$data[] = new User(); // 添加对象
$data[] = ['city' => 'New York']; // 添加嵌套数组
print_r($data);
/*
Array
(
[0] => User Object
(
)
[1] => Array
(
[city] => New York
)
)
*/
?>

6.3 数组作为值传递与引用传递

在 PHP 5.x 中，当函数修改数组时，如果数组不是通过引用传递的（例如 `array_push()` 的第一个参数在 PHP 7 之前不是引用），则会创建数组的副本，可能导致性能问题。PHP 7.0 以后，`array_push()` 等函数内部实现了对数组的优化处理，通常不会在内部创建完整副本，而是直接修改。但重要的是要理解，像 `array_merge()` 这样的函数总是返回一个新数组。

七、总结

PHP 提供了多种灵活且强大的方式来向数组中添加数据，每种方法都有其特定的使用场景和优缺点。选择哪种方法取决于您的具体需求，包括：
您是要添加单个元素还是多个元素？
您是要在数组末尾添加，还是在特定位置插入？
您是否需要处理键冲突，以及如何处理？
您对性能和内存是否有严格要求？

掌握这些方法，并理解它们之间的差异，将使您能够编写出更高效、更健壮、更易于维护的 PHP 代码。在实际开发中多加练习，将这些知识融会贯通，您将成为一名更优秀的 PHP 程序员。

2026-04-06

---

下一篇：PHP 如何安全高效地获取并利用前端存储数据