Array associativi in PHP: coppie chiave valore

Un array associativo memorizza ogni valore sotto una chiave scelta da te, scritta come key => value: $user = ['name' => 'Ada', 'age' => 36];. Leggi un valore con $user['name'], e aggiungine o modificane uno assegnando alla sua chiave: $user['email'] = 'ada@example.com';.

<?php
$user = [
    'name' => 'Ada',
    'age'  => 36,
    'city' => 'London',
];

echo $user['name'], "\n";
echo $user['age'], "\n";

$user['email'] = 'ada@example.com';   // add a pair
$user['city']  = 'Paris';             // change a value

print_r($user);

In altri linguaggi la stessa struttura si chiama dizionario, mappa o hash. In PHP è un normale array le cui chiavi sono stringhe invece di 0, 1, 2.

Aggiungere, modificare e rimuovere coppie

Assegnare a una chiave che non esiste la aggiunge in fondo. Assegnare a una chiave che esiste già ne sostituisce il valore e ne mantiene la posizione. unset() rimuove una coppia.

<?php
$stock = ['apples' => 10, 'pears' => 4];

$stock['plums'] = 7;      // new key: added at the end
$stock['apples'] = 12;    // existing key: value replaced
$stock['pears']--;        // change in place
unset($stock['plums']);   // remove a pair

print_r($stock);

Qui array_push() non aiuta: può solo accodare valori con chiavi numeriche. Per aggiungere più coppie insieme, usa array_merge($stock, $more), dove vincono i nuovi valori, oppure $stock + $more, dove le chiavi esistenti mantengono i loro valori; la pagina su array_merge confronta i due.

Scorrere chiavi e valori

foreach ($array as $key => $value) percorre le coppie nell'ordine in cui sono state aggiunte. Togli $key => quando ti servono solo i valori.

<?php
$capitals = [
    'France'  => 'Paris',
    'Japan'   => 'Tokyo',
    'Brazil'  => 'Brasília',
];

foreach ($capitals as $country => $capital) {
    echo "The capital of $country is $capital.\n";
}

foreach ($capitals as $capital) {
    echo mb_strtoupper($capital), "\n";
}

Ottenere tutte le chiavi o tutti i valori

array_keys() restituisce le chiavi come lista semplice e array_values() restituisce i valori, entrambi reindicizzati da 0. Passa a array_keys() un secondo argomento e restituirà solo le chiavi che contengono quel valore: è così che trovi ogni chiave di un valore.

<?php
$grades = ['Ada' => 'A', 'Linus' => 'B', 'Grace' => 'A'];

print_r(array_keys($grades));
print_r(array_values($grades));
print_r(array_keys($grades, 'A'));    // keys whose value is 'A'

echo array_search('B', $grades), "\n"; // first key with value 'B'

Per una sola chiave, array_search() restituisce la prima corrispondenza, oppure false quando non ce n'è. La pagina su array_search spiega perché devi confrontare quel risultato con !== false.

Verificare se una chiave esiste

isset($arr['key']) è il controllo abituale e il più veloce, ma restituisce false quando la chiave esiste e contiene null. array_key_exists('key', $arr) in quel caso restituisce true. Per leggere con un valore di ripiego, l'operatore ?? fa entrambe le cose insieme.

<?php
$settings = ['theme' => 'dark', 'font' => null];

var_dump(isset($settings['theme']));
var_dump(isset($settings['font']));            // null counts as not set
var_dump(array_key_exists('font', $settings)); // the key is there

$size = $settings['size'] ?? 14;               // default when missing
echo $size, "\n";

Ordinare per chiave o per valore

ksort() ordina per chiave e asort() per valore, entrambe tenendo ogni chiave legata al suo valore. krsort() e arsort() ordinano al contrario. Non usare sort() su un array associativo: butta via le chiavi e rinumera da 0.

<?php
$population = ['Tokyo' => 37, 'Delhi' => 32, 'Shanghai' => 29, 'Cairo' => 22];

ksort($population);       // A to Z by city
print_r($population);

arsort($population);      // largest value first
print_r($population);

sort($population);        // keys are lost
print_r($population);

Tutte queste ordinano sul posto e restituiscono true, quindi $sorted = ksort($arr) ti dà true, non un array. Gli ordinamenti personalizzati usano uasort() e uksort().

Invertire, contare e convertire in JSON

Alcune funzioni di una riga tornano spesso con i dati chiave valore: array_flip() scambia chiavi e valori, array_count_values() conta quante volte compare ogni valore e json_encode() trasforma l'array in un oggetto JSON.

<?php
$codes = ['red' => '#f00', 'green' => '#0f0', 'blue' => '#00f'];

print_r(array_flip($codes));           // look up a name by code

$votes = ['yes', 'no', 'yes', 'yes', 'no'];
print_r(array_count_values($votes));   // value => how many times

echo json_encode($codes), "\n";

Errore comune: leggere una chiave che non c'è

Leggere una chiave mancante restituisce null, ma il tuo PHP stampa anche un warning:

<?php
$user = ['name' => 'Ada'];
echo $user['phone'];

Warning: Undefined array key "phone" in /var/www/html/index.php on line 3

Dai alla lettura un default con ??, che non genera mai warning, oppure controlla prima con isset() quando il caso mancante richiede un suo ramo.

<?php
$user = ['name' => 'Ada', 'email' => 'ada@example.com'];

$phone = $user['phone'] ?? 'no phone on file';
echo $phone, "\n";

if (isset($user['email'])) {
    echo "Send mail to {$user['email']}\n";
}

Dentro una stringa tra virgolette doppie, racchiudi l'accesso tra graffe, "{$user['email']}". Senza, PHP accetta solo la forma senza apici "$user[email]", in cui è facile sbagliare.