PHP array_column(): obtener una columna de las filas

array_column($rows, $column) devuelve el valor de $column de cada fila de una lista de filas. Convierte una tabla de registros en un array plano de un solo campo, que es lo que necesitas antes de implode, in_array, array_sum o 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";

Las filas pueden venir de cualquier sitio: una respuesta JSON decodificada, un archivo CSV o una consulta a una base de datos que devolvió un array de arrays asociativos.

Usar la clave de índice para construir pares clave valor

El tercer argumento indica un campo cuyo valor se convierte en la clave de cada resultado. array_column($users, 'name', 'id') es la forma habitual de construir una tabla de búsqueda de id a nombre, por ejemplo para una lista <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";

Si dos filas comparten el mismo valor de índice, la fila posterior sobrescribe a la anterior.

Indexar filas completas por id con null

Pasa null como columna para conservar cada fila completa, con la clave del campo de índice. Buscar una fila por id pasa a ser un acceso directo por clave en lugar de un bucle.

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

Construye el índice una vez y cada búsqueda posterior es instantánea, lo que importa cuando buscas muchos ids dentro de un bucle.

Encontrar una fila con array_column y array_search

Para saber qué fila tiene un valor dado, busca en la columna y usa la posición que obtienes. Comprueba el resultado con !== false, porque una coincidencia en la primera fila devuelve 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));

Esto depende de que $users tenga las claves 0, 1, 2, porque array_column devuelve una lista. Si el array se filtró y tiene huecos, llama antes a array_values($users). La página de array_search explica en detalle la trampa de false frente a 0.

Sumar, contar o promediar una columna

array_column combina bien con las funciones matemáticas: extrae el campo y luego súmalo.

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

Para un valor calculado a partir de varios campos, como cantidad por precio, la herramienta es array_map, como en la última línea.

array_column con objetos

Con una lista de objetos, array_column lee las propiedades públicas. Las propiedades privadas y protegidas no son visibles para ella.

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

La segunda llamada devuelve un array vacío: password es privada, así que se salta cada objeto.

Las filas a las que les falta el campo se saltan

array_column no rellena un valor de relleno para una fila que no tiene el campo. El resultado puede ser más corto que la entrada, así que sus posiciones dejan de coincidir con las filas.

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

El primer resultado tiene dos teléfonos y ninguna pista de que Bob no tenía. Con el nombre como clave de índice, puedes ver de quién es cada número, que es la forma más segura siempre que a algunas filas les pueda faltar el campo.