php array_column PHP array_column() 函数

php array_column

PHP array_column 函数是 PHP 5.5 版本中新增的函数，它可以从多维数组中返回单列的值。它可以提取多维数组中指定键名的值，并将其作为一个新的一维数组返回。

$records = array(
    array(
        'id' => 2135,
        'first_name' => 'John',
        'last_name' => 'Doe',
    ),
    array(
        'id' => 3245,
        'first_name' => 'Sally',
        'last_name' => 'Smith',
    ),
    array(
        'id' => 5342,
        'first_name' => 'Jane', 
        'last_name' => 'Jones', 

    ), 

    array( 

        'id' => 5623, 

        'first_name' => 'Peter', 

        'last_name' => 'Doe', 

    ) 

 ); 

 $first_names = array_column($records, ‘first_name’); 

 print_r($first_names);   // Array ( [0] => John [1] => Sally [2] => Jane [3] => Peter )   

array_column() 函数有三个必须的参数，分别是输入的多维数组、要提取的键名、以及要返回的新一维数组。此外，它还有一个可选参数，用于指定要提取哪些行（即键名对应的值）。如果不使用该参数，array_column() 函数会返回所有行。

array_column() 函数在处理大量多维数据时特别有用。例如，当我们想要获得一个包含所有用户 ID 的一位数组时，就可以使用该函数来快速获得所需信息。

总之，PHP array_column 函数是一个强大而方便的函数，能够帮助我们快速在多维数组中获得所需信息。

PHP array_column() 函数

PHP array_column() 函数

完整的 PHP Array 参考手册

实例

从记录集中取出 last_name 列：

<?php
// 可能从数据库中返回数组
$a = array(
  array(
    'id' => 5698,
    'first_name' => 'Peter',
    'last_name' => 'Griffin',
  ),
  array(
    'id' => 4767,
    'first_name' => 'Ben',
    'last_name' => 'Smith',
  ),
  array(
    'id' => 3809,
    'first_name' => 'Joe',
    'last_name' => 'Doe',
  )
);

$last_names = array_column($a, 'last_name');
print_r($last_names);
?>

输出：

Array
(
  [0] => Griffin
  [1] => Smith
  [2] => Doe
)

---

定义和用法

array_column() 返回输入数组中某个单一列的值。

---

语法

array_column(array,column_key,index_key);

参数	描述
array	必需。指定要使用的多维数组（记录集）。
column_key	必需。需要返回值的列。可以是索引数组的列的整数索引，或者是关联数组的列的字符串键值。该参数也可以是 NULL，此时将返回整个数组（配合index_key 参数来重置数组键的时候，非常管用）。
index_key	可选。作为返回数组的索引/键的列。

技术细节

返回值：	返回一个数组，数组的值为输入数组中某个单一列的值。
PHP 版本：	5.5+

---

更多实例

实例 1

从记录集中取出 last_name 列，用相应的 "id" 列作为键值：

<?php
// 可能从数据库中返回数组
$a = array(
  array(
    'id' => 5698,
    'first_name' => 'Peter',
    'last_name' => 'Griffin',
  ),
  array(
    'id' => 4767,
    'first_name' => 'Ben',
    'last_name' => 'Smith',
  ),
  array(
    'id' => 3809,
    'first_name' => 'Joe',
    'last_name' => 'Doe',
  )
);

$last_names = array_column($a, 'last_name', 'id');
print_r($last_names);
?>

输出：

Array
(
  [5698] => Griffin
  [4767] => Smith
  [3809] => Doe
)

---

完整的 PHP Array 参考手册