HOWTO · PHP

在 PHP 中推送元素到关联数组

在本教程中,我们将了解如何在 PHP 中将项目或元素添加到关联数组中。

本页内容

向 PHP 关联数组添加元素时,应根据所需的键选择操作:array_push() 使用数字键追加值,array_merge() 则可在指定的字符串键下添加条目。如果两个数组含有相同的字符串键,array_merge() 会保留后一个值;array_merge_recursive() 则会将冲突的值组合成一个数组。
下面的代码示例已经执行,结果与下文描述的行为一致。

什么是 PHP 中的关联数组?

PHP 数组是有序映射:每个值都存储在整数键或字符串键下。因此,数组可以用作列表、名称到值的映射,也可以兼具两种用途。以字符串为键的数组通常称为关联数组。键让你可以按含义而非位置获取值,例如下面的 $age['Mike']。

运行此示例(代码及输出中的标签保留英文):

本节中的代码以及显示的标签或输出仍为英文。

<?php
$age = ['Mike' => 24, 'Ann' => 19, 'Alice' => 32];
echo "Mike is {$age['Mike']} years old.";

当每个值都有稳定的标签时,这种结构很有用,例如姓名、产品 SKU 或配置选项。读取条目时应使用相同的键拼写;键区分大小写,因此 'Mike' 和 'mike' 表示不同的条目。数组可以同时包含字符串键和整数键,因此添加值时选择哪种操作很重要。

使用 array_push() 追加值

array_push() 是一个函数,可将一个或多个值追加到数组末尾。PHP 会为追加的值分配整数键;该函数不能让你指定 'c' 这样的字符串键。即使数组中已有命名条目,只要新值属于数字序列,就可以使用它。如果需要指定名称,请改用下一节介绍的合并方式。

以下示例的代码及输出标签保留英文。

本节中的代码以及显示的标签或输出仍为英文。

<?php
$color = ['a' => 'Red', 'b' => 'Blue'];
array_push($color, 'Green', 'White');
print_r($color);

两个新值会按顺序追加并获得整数键,原有的字符串键条目则会保留。只追加一个值时,$color[] = 'Green'; 是一种简洁的替代写法,追加行为相同。这两种写法都不会创建新的命名条目。如果后续代码依赖整数键,请检查生成的键,不要假定该数组是从零开始的列表。

使用 array_merge() 添加命名条目

要添加命名条目,可以先创建一个包含该键和值的小型关联数组,再将它与原数组合并。返回的数组包含两个输入数组中的条目;将返回值赋给原变量会更新该变量,而直接使用返回值则不会改变原变量。

以下示例的代码及输出标签保留英文。

本节中的代码以及显示的标签或输出仍为英文。

<?php
$age = ['Mike' => 24, 'Ann' => 19, 'Alice' => 19];
$age = array_merge($age, ['John' => 22]);
print_r($age);

在此示例中,'John' 仍是字符串键,因此可以通过 $age['John'] 访问。你可以传入两个以上的数组,数组的顺序会影响结果。对于重复出现的字符串键,后一个数组中的值会替换前一个值。例如,将 ['b' => 'Blue'] 与 ['b' => 'Neon'] 合并后,结果是 'b' => 'Neon'。当后续设置需要覆盖默认值时,这种替换行为很有用,但该键原先的值会被丢弃。

整数键遵循另一条规则:array_merge() 会按遇到顺序从零开始重新编号结果中的数字键。因此,如果必须保留原有整数键,就不要使用它。简单地添加命名条目时,也可以使用数组联合运算符 +;它会保留键,并在键重复时保留左侧的值。只有当你需要这种优先级时才选择它。

使用 array_merge_recursive() 处理重复的字符串键

如果希望重复字符串键对应的值都保留下来,array_merge_recursive() 会将这些值组合成该键下的一个数组。这与 array_merge() 不同,后者会替换较早出现的值。它还会改变值的结构:如果原先的代码预期 $color['b'] 是字符串,现在就必须按数组处理。适合保留分组值时再使用此函数,不要把它当作普通合并的直接替代品。

以下示例的代码及输出标签保留英文。

本节中的代码以及显示的标签或输出仍为英文。

<?php
$color = ['a' => 'Red', 'b' => 'Blue'];
$otherColor = ['b' => 'Neon', 'c' => 'Green'];
$result = array_merge_recursive($color, $otherColor);
print_r($result);

结果中的 'a' 和 'c' 仍是单个值,而 'b' 包含 'Blue' 和 'Neon',并以带索引的数组形式存储。如果重复键原本对应一个数组,递归合并还可能组合其中的嵌套值;在将结果当作标量处理前,应先检查其结构。简而言之,使用 array_push() 追加带数字键的值,使用 array_merge() 添加命名条目并让后一个值覆盖前一个值;只有在确实需要合并重复值并接受由此产生的嵌套结构时,才使用 array_merge_recursive()。