PHP array_column()函數詳解與實用示例

M66 2025-07-10

PHP array_column()函數簡介

在PHP開發中，常常需要從多維數組中獲取某個特定鍵對應的所有值，array_column()函數正是為此設計。該函數自PHP 5.5.0版本起引入，能夠簡潔高效地從多維數組中提取指定列，返回一個包含這些值的一維數組。

array_column()函數語法及參數說明

函數的基本語法如下：

 <span class="fun">array_column(array $input, mixed $column_key [, mixed $index_key = null])</span>

$input ：必需，輸入的多維數組。
$column_key ：必需，需要提取的鍵名或鍵的值。
$index_key ：可選，用作返回數組的索引鍵。

函數返回一個一維數組，包含所有指定鍵的值，若指定了$index_key ，則會以該鍵對應的值作為結果數組的鍵。

基本示例：提取指定鍵的值

<?php
$users = [
    ['id' => 1, 'name' => 'John', 'email' => 'john@example.com'],
    ['id' => 2, 'name' => 'Jane', 'email' => 'jane@example.com'],
    ['id' => 3, 'name' => 'Smith', 'email' => 'smith@example.com'],
];

// 提取所有'name'鍵的值
$names = array_column($users, 'name');
print_r($names);
// 輸出結果：Array ( [0] => John [1] => Jane [2] => Smith )
?>

以上代碼通過array_column()快速提取了所有用戶的名字，結果為包含名字的一維數組。

進階用法：使用指定鍵作為索引

<?php
$users = [
    ['id' => 1, 'name' => 'John', 'email' => 'john@example.com', 'age' => 25],
    ['id' => 2, 'name' => 'Jane', 'email' => 'jane@example.com', 'age' => 30],
    ['id' => 3, 'name' => 'Smith', 'email' => 'smith@example.com', 'age' => 35],
];

// 以'id'作為鍵，'name'作為值生成關聯數組
$result = array_column($users, 'name', 'id');
print_r($result);
// 輸出結果：Array ( [1] => John [2] => Jane [3] => Smith )
?>

此示例通過設置$index_key參數，將用戶的ID用作數組的索引，方便按ID快速訪問對應的姓名。

總結

array_column()函數是PHP中處理多維數組數據的利器。它簡化了從復雜數組中提取特定列的操作，提升代碼的可讀性和執行效率。掌握其用法能夠幫助開發者更輕鬆地處理數據集合。

參考資料

PHP官方手冊：array_column函數說明

array_column