1. 问题场景：从嵌套数组中提取特定键的值
在 php 开发中，我们经常会遇到包含多层嵌套结构的数组。例如，一个订单列表可能包含多个商品项，每个商品项又是一个关联数组。假设我们有以下这样的数组结构，其中包含多个商品记录，每个记录都嵌套在名为 item 的键下：
$data = [
[
'id' => 101,
'item' => [
'name' => '商品A',
'price' => 100,
'quantity' => 1
],
'status' => '已支付'
],
[
'id' => 102,
'item' => [
'name' => '商品B',
'price' => 200,
'quantity' => 2
],
'status' => '待发货'
],
[
'id' => 103,
'item' => [
'name' => '商品C',
'price' => 150,
'quantity' => 1
],
'status' => '已完成'
]
];我们的目标是提取所有 item 键对应的值（即每个商品的详细信息数组），形成一个仅包含这些商品信息的新数组，如下所示：
[
[
'name' => '商品A',
'price' => 100,
'quantity' => 1
],
[
'name' => '商品B',
'price' => 200,
'quantity' => 2
],
[
'name' => '商品C',
'price' => 150,
'quantity' => 1
]
]在这种情况下，直接使用 array_values() 函数并不能达到预期效果。array_values() 仅用于返回数组中所有值的新数组，并重新建立数字索引，它不会深入到嵌套结构中去提取特定键的值。
2. 解决方案：使用 array_column()
PHP 提供了 array_column() 函数，专门用于从多维数组中获取指定键的所有值。它是解决上述问题的理想工具。
array_column() 函数的语法如下：
立即学习“PHP免费学习笔记（深入）”；
array_column(array $input, mixed $column_key, mixed $index_key = null): array
- $input: 必需。指定要处理的多维数组。
- $column_key: 必需。指定要返回值的列的键名或索引。它可以是一个字符串（键名）或一个整数（索引）。如果设置为 null，则返回所有列。
- $index_key: 可选。指定用作返回数组的索引的列的键名或索引。
根据我们的需求，我们需要从 $data 数组中提取所有 item 键对应的值。因此，$input 是 $data，$column_key 是 'item'。
示例代码：
101,
'item' => [
'name' => '商品A',
'price' => 100,
'quantity' => 1
],
'status' => '已支付'
],
[
'id' => 102,
'item' => [
'name' => '商品B',
'price' => 200,
'quantity' => 2
],
'status' => '待发货'
],
[
'id' => 103,
'item' => [
'name' => '商品C',
'price' => 150,
'quantity' => 1
],
'status' => '已完成'
]
];
// 使用 array_column 提取所有 'item' 键的值
$items = array_column($data, 'item');
echo '';
print_r($items);
echo '
';
?>输出结果：
Array
(
[0] => Array
(
[name] => 商品A
[price] => 100
[quantity] => 1
)
[1] => Array
(
[name] => 商品B
[price] => 200
[quantity] => 2
)
[2] => Array
(
[name] => 商品C
[price] => 150
[quantity] => 1
)
)可以看到，array_column() 成功地从原始嵌套数组中提取了所有 item 键对应的子数组，并将其组织成了一个新的索引数组，完全符合我们的预期。
3. array_values() 与 array_column() 的区别
理解这两个函数的适用场景有助于避免混淆：
-
array_values(): 主要用于处理一维数组或将多维数组的第一层键值对转换为值列表。它会丢弃原有的所有键（无论是数字键还是字符串键），并为新数组生成从 0 开始的数字索引。它不会“深入”到嵌套数组内部去提取特定键的值。
- 适用场景: 当你需要一个数组的所有值，并且不关心原有键名，或者需要将关联数组转换为索引数组时。
-
array_column(): 专门用于从多维数组（通常是包含多个关联数组的数组）中提取指定键的所有值。它可以提取标量值，也可以提取子数组。
- 适用场景: 当你需要从一个“表格型”或“列表型”的多维数组中抽取某一列数据时。
4. 注意事项
-
键不存在时的行为: 如果 $column_key 在某个子数组中不存在，array_column() 会在该位置填充 null 值。
$data_with_missing_key = [ ['id' => 1, 'name' => 'Alice'], ['id' => 2, 'age' => 30], // 缺少 'name' 键 ]; $names = array_column($data_with_missing_key, 'name'); // 结果: ['Alice', null] -
第三个参数 $index_key: array_column() 的第三个参数允许你指定一个键，其对应的值将作为结果数组的键。这在需要根据某个唯一标识符来索引结果数组时非常有用。
$users = [ ['id' => 101, 'name' => 'Alice', 'email' => 'alice@example.com'], ['id' => 102, 'name' => 'Bob', 'email' => 'bob@example.com'], ]; // 提取所有 email，并以 id 作为键 $emails_indexed_by_id = array_column($users, 'email', 'id'); /* Array ( [101] => alice@example.com [102] => bob@example.com ) */ - 性能: 对于大型数组，array_column() 通常比手动循环遍历并提取值更高效，因为它是在 C 语言层面实现的。
5. 总结
array_column() 是 PHP 中处理多维数组的强大工具，它能以简洁高效的方式从复杂数据结构中提取指定键的所有值。当 array_values() 无法满足从嵌套数组中抽取特定“列”数据的需求时，array_column() 往往是正确的选择。掌握其用法，可以显著提高代码的可读性和执行效率，是 PHP 开发者必备的技能之一。
