PHP array_column(): estrarre una colonna dalle righe

array_column($rows, $column) restituisce il valore di $column da ogni riga di una lista di righe. Trasforma una tabella di record in un array piatto di un solo campo, ciò che ti serve prima di 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";

Le righe possono arrivare da qualsiasi parte: una risposta JSON decodificata, un file CSV o una query al database che ha restituito un array di array associativi.

Usare la chiave indice per costruire coppie chiave valore

Il terzo argomento indica un campo il cui valore diventa la chiave di ogni risultato. array_column($users, 'name', 'id') è il modo consueto per costruire una tabella da id a nome, per esempio per 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";

Se due righe hanno lo stesso valore indice, la riga successiva sovrascrive la precedente.

Indicizzare le righe intere per id con null

Passa null come colonna per tenere ogni riga intera, con il campo indice come nuova chiave. Cercare una riga per id diventa così un accesso diretto per chiave invece di un ciclo.

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

Costruisci l'indice una volta e ogni ricerca successiva è istantanea, il che conta quando cerchi molti id in un ciclo.

Trovare una riga con array_column e array_search

Per trovare quale riga ha un certo valore, cerca nella colonna e usa la posizione che ottieni. Verifica il risultato con !== false, perché una corrispondenza nella prima riga restituisce 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));

Questo presuppone che $users abbia le chiavi 0, 1, 2, perché array_column restituisce una lista. Se l'array è stato filtrato e ha dei buchi, chiama prima array_values($users). La pagina su array_search tratta in dettaglio la trappola false contro 0.

Sommare, contare o fare la media di una colonna

array_column si abbina bene alle funzioni matematiche: estrai il campo, poi sommalo.

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

Per un valore calcolato da più campi, come quantità per prezzo, lo strumento è array_map, come nell'ultima riga.

array_column con gli oggetti

Con una lista di oggetti, array_column legge le proprietà pubbliche. Le proprietà private e protected per lei non sono visibili.

<?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 seconda chiamata restituisce un array vuoto: password è privata, quindi ogni oggetto viene saltato.

Le righe senza il campo vengono saltate

array_column non inserisce un segnaposto per una riga a cui manca il campo. Il risultato può essere più corto dell'input, quindi le sue posizioni non corrispondono più alle righe.

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

Il primo risultato ha due numeri di telefono e nessun indizio che Bob non ne avesse. Con il nome come chiave indice vedi di chi è ogni numero, ed è la forma più sicura ogni volta che ad alcune righe potrebbe mancare il campo.