array_column() trong PHP: lấy một cột từ các hàng dữ liệu

array_column($rows, $column) trả về giá trị của $column từ mọi hàng trong một danh sách các hàng. Hàm này biến một bảng bản ghi thành một mảng phẳng chỉ chứa một trường, đúng thứ bạn cần trước khi dùng implode, in_array, array_sum hay array_search.

<?php
$users = [
    ["id" => 3, "name" => "Ada", "email" => "ada@example.com"],
    ["id" => 7, "name" => "Bob", "email" => "bob@example.com"],
    ["id" => 9, "name" => "Cy", "email" => "cy@example.com"],
];

$emails = array_column($users, "email");
print_r($emails);

echo implode(", ", array_column($users, "name")), "\n";

Các hàng có thể đến từ bất cứ đâu: một response JSON đã được decode, một tệp CSV, hoặc một truy vấn cơ sở dữ liệu trả về mảng gồm các mảng kết hợp.

Dùng index key để tạo cặp key value

Đối số thứ ba chỉ định một trường mà giá trị của nó sẽ thành khóa của từng kết quả. array_column($users, 'name', 'id') là cách thường dùng để dựng bảng tra cứu từ id sang tên, chẳng hạn cho một danh sách <select>.

<?php
$users = [
    ["id" => 3, "name" => "Ada", "role" => "admin"],
    ["id" => 7, "name" => "Bob", "role" => "editor"],
    ["id" => 9, "name" => "Cy", "role" => "viewer"],
];

$names = array_column($users, "name", "id");
print_r($names);

echo $names[7], "\n";

Nếu hai hàng có cùng giá trị index, hàng sau sẽ ghi đè hàng trước.

Đánh chỉ mục cả hàng theo id với null

Truyền null làm cột để giữ nguyên từng hàng, với khóa mới lấy từ trường index. Khi đó, tìm một hàng theo id chỉ là truy cập khóa trực tiếp thay vì một vòng lặp.

<?php
$products = [
    ["sku" => "A12", "name" => "Lamp", "price" => 29],
    ["sku" => "B07", "name" => "Desk", "price" => 199],
    ["sku" => "C33", "name" => "Chair", "price" => 89],
];

$bySku = array_column($products, null, "sku");

$sku = "B07";
if (isset($bySku[$sku])) {
    echo "{$bySku[$sku]['name']} costs {$bySku[$sku]['price']}\n";
}

print_r(array_keys($bySku));

Dựng chỉ mục một lần, sau đó mọi lần tra cứu đều có kết quả ngay, điều này quan trọng khi bạn tra nhiều id trong một vòng lặp.

Tìm một hàng bằng array_column và array_search

Để biết hàng nào có một giá trị cho trước, hãy tìm trong cột rồi dùng vị trí nhận được. Kiểm tra kết quả bằng !== false, vì một kết quả khớp ở hàng đầu tiên sẽ trả về 0.

<?php
$users = [
    ["name" => "Ada", "email" => "ada@example.com"],
    ["name" => "Bob", "email" => "bob@example.com"],
    ["name" => "Cy", "email" => "cy@example.com"],
];

$wanted = "bob@example.com";
$index = array_search($wanted, array_column($users, "email"));

if ($index !== false) {
    echo "Found: {$users[$index]['name']} at position $index\n";
} else {
    echo "No user with $wanted\n";
}

// Just checking existence
var_dump(in_array("zoe@example.com", array_column($users, "email"), true));

Cách này dựa vào việc $users có các khóa 0, 1, 2, vì array_column trả về một list. Nếu mảng đã được lọc và có khóa bị khuyết, hãy gọi array_values($users) trước. Trang array_search giải thích chi tiết cái bẫy false với 0.

Tính tổng, đếm hoặc tính trung bình một cột

array_column kết hợp rất tốt với các hàm toán học: lấy trường ra rồi cộng lại.

<?php
$cart = [
    ["item" => "Book", "qty" => 2, "price" => 12.5],
    ["item" => "Pen", "qty" => 10, "price" => 1.2],
    ["item" => "Bag", "qty" => 1, "price" => 30.0],
];

$qtys = array_column($cart, "qty");
echo "Items: " . array_sum($qtys) . "\n";

$prices = array_column($cart, "price");
echo "Most expensive: " . max($prices) . "\n";
echo "Average price: " . round(array_sum($prices) / count($prices), 2) . "\n";

$total = array_sum(array_map(fn($row) => $row["qty"] * $row["price"], $cart));
echo "Total: $total\n";

Với một giá trị được tính từ nhiều trường, như số lượng nhân giá, công cụ phù hợp là array_map, như ở dòng cuối cùng.

array_column với đối tượng

Với một danh sách đối tượng, array_column đọc các thuộc tính public. Nó không nhìn thấy các thuộc tính private và protected.

<?php
class User
{
    public function __construct(
        public int $id,
        public string $name,
        private string $password,
    ) {}
}

$users = [
    new User(1, "Ada", "x"),
    new User(2, "Bob", "y"),
];

print_r(array_column($users, "name", "id"));
var_dump(array_column($users, "password"));

Lần gọi thứ hai trả về mảng rỗng: password là private, nên mọi đối tượng đều bị bỏ qua.

Hàng thiếu trường sẽ bị bỏ qua

array_column không điền giá trị thay thế cho hàng thiếu trường. Kết quả có thể ngắn hơn đầu vào, nên vị trí của nó không còn khớp với các hàng.

<?php
$people = [
    ["name" => "Ada", "phone" => "555-0101"],
    ["name" => "Bob"],
    ["name" => "Cy", "phone" => "555-0199"],
];

print_r(array_column($people, "phone"));

// Keep the link to each person with an index key
print_r(array_column($people, "phone", "name"));

Kết quả đầu tiên có hai số điện thoại mà không có dấu hiệu nào cho thấy Bob không có số. Khi dùng tên làm index key, bạn sẽ thấy số nào của ai, và đây là cách an toàn hơn mỗi khi có hàng có thể thiếu trường.