PHP array_column() : extraire une colonne de lignes

array_column($rows, $column) renvoie la valeur de $column pour chaque ligne d'une liste de lignes. Elle transforme une table d'enregistrements en tableau à plat d'un seul champ, ce dont vous avez besoin avant implode, in_array, array_sum ou 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";

Les lignes peuvent venir de n'importe où : une réponse JSON décodée, un fichier CSV, ou une requête en base de données qui a renvoyé un tableau de tableaux associatifs.

Utiliser la clé d'index pour construire des paires clé valeur

Le troisième argument désigne un champ dont la valeur devient la clé de chaque résultat. array_column($users, 'name', 'id') est la façon habituelle de construire une table de correspondance id vers nom, par exemple pour une liste <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 deux lignes partagent la même valeur d'index, la ligne suivante écrase la précédente.

Indexer des lignes entières par id avec null

Passez null comme colonne pour garder chaque ligne complète, réindexée par le champ d'index. Chercher une ligne par id devient alors un accès direct par clé au lieu d'une boucle.

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

Construisez l'index une fois et chaque recherche ensuite est instantanée, ce qui compte quand vous cherchez beaucoup d'ids dans une boucle.

Trouver une ligne avec array_column et array_search

Pour trouver quelle ligne contient une valeur donnée, cherchez dans la colonne et utilisez la position renvoyée. Vérifiez le résultat avec !== false, car une correspondance dans la première ligne renvoie 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));

Cela suppose que $users a les clés 0, 1, 2, car array_column renvoie une liste. Si le tableau a été filtré et a des trous, appelez d'abord array_values($users). La page array_search détaille le piège false ou 0.

Additionner, compter ou faire la moyenne d'une colonne

array_column s'associe bien aux fonctions mathématiques : extrayez le champ, puis additionnez-le.

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

Pour une valeur calculée à partir de plusieurs champs, comme quantité fois prix, l'outil est array_map, comme sur la dernière ligne.

array_column avec des objets

Avec une liste d'objets, array_column lit les propriétés publiques. Les propriétés privées et protégées ne lui sont pas visibles.

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

Le second appel renvoie un tableau vide : password est privée, donc chaque objet est ignoré.

Les lignes sans le champ sont ignorées

array_column ne met pas de valeur de remplacement pour une ligne qui n'a pas le champ. Le résultat peut être plus court que l'entrée, et ses positions ne correspondent alors plus aux lignes.

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

Le premier résultat contient deux téléphones sans indiquer que Bob n'en avait pas. Avec le nom comme clé d'index, vous voyez à qui appartient chaque numéro, ce qui est la forme la plus sûre chaque fois que certaines lignes peuvent ne pas avoir le champ.