PHP array_column(): 행에서 열 하나 가져오기

array_column($rows, $column)는 행 목록의 모든 행에서 $column의 값을 반환합니다. 레코드의 표를 필드 하나의 평평한 배열로 바꾸며, implode, in_array, array_sum, 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";

행은 어디서든 올 수 있습니다. 디코딩한 JSON 응답, CSV 파일, 연관 배열의 배열을 반환한 데이터베이스 쿼리 등입니다.

인덱스 키로 키와 값 쌍 만들기

세 번째 인수는 그 값이 각 결과의 키가 될 필드를 지정합니다. array_column($users, 'name', 'id')는 예를 들어 <select> 목록을 위해 id에서 이름으로 가는 조회 테이블을 만드는 일반적인 방법입니다.

<?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";

두 행의 인덱스 값이 같으면 나중 행이 앞의 행을 덮어씁니다.

null로 행 전체를 id로 인덱싱하기

열 자리에 null을 넘기면 각 행 전체를 유지하면서 인덱스 필드로 키를 다시 정합니다. 그러면 id로 행을 찾는 것이 반복문이 아니라 키 접근 한 번이 됩니다.

<?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));

인덱스를 한 번 만들면 그 뒤의 모든 조회가 즉시 끝나며, 반복문에서 많은 id를 찾을 때 중요합니다.

array_column과 array_search로 행 찾기

특정 값을 가진 행을 찾으려면 열을 검색하고 돌려받은 위치를 쓰세요. 첫 번째 행에서 일치하면 0이 반환되므로 결과를 !== false로 확인하세요.

<?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));

array_column은 리스트를 반환하므로 이 방법은 $users의 키가 0, 1, 2라는 것에 의존합니다. 배열을 필터링해서 빈틈이 있다면 먼저 array_values($users)를 호출하세요. false와 0 함정은 array_search 페이지에서 자세히 다룹니다.

열 합계, 개수, 평균

array_column은 수학 헬퍼와 잘 어울립니다. 필드를 뽑은 다음 더하세요.

<?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";

수량 곱하기 가격처럼 여러 필드로 계산한 값이라면 마지막 줄처럼 array_map이 맞는 도구입니다.

객체와 함께 쓰는 array_column

객체 목록에서 array_column은 public 속성을 읽습니다. private과 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"));

두 번째 호출은 빈 배열을 반환합니다. password가 private이므로 모든 객체를 건너뜁니다.

필드가 없는 행은 건너뛴다

array_column은 필드가 없는 행에 자리 표시 값을 채우지 않습니다. 결과가 입력보다 짧을 수 있어서 위치가 더 이상 행과 맞지 않습니다.

<?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"));

첫 번째 결과에는 전화번호가 두 개 있고 Bob에게 번호가 없었다는 단서가 없습니다. 이름을 인덱스 키로 쓰면 누구의 번호인지 알 수 있으므로, 일부 행에 필드가 없을 수 있다면 이 형태가 더 안전합니다.