Array multidimensionali in PHP: array annidati e cicli

Un array multidimensionale è un array i cui elementi sono array. Lo leggi con una coppia di parentesi per livello: $grid[1][2] è la riga 1, colonna 2, e $users[0]['name'] è il nome nel primo record.

<?php
$grid = [
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9],
];

echo $grid[1][2], "\n";   // row 1, column 2

$users = [
    ['name' => 'Ada',   'role' => 'admin'],
    ['name' => 'Linus', 'role' => 'editor'],
];

echo $users[0]['name'], "\n";
echo $users[1]['role'], "\n";

$grid[2][0] = 70;         // change a nested value
echo implode(' ', $grid[2]), "\n";

La seconda forma, una lista di record con campi con nome, è quella che incontrerai più spesso: è ciò che di solito ti restituiscono una query al database, una risposta JSON decodificata o un file CSV letto. Ogni record è un array associativo.

Creare array annidati

L'annidamento può essere profondo quanto serve e i livelli possono mescolare chiavi numeriche e stringhe. Un array di configurazione è un esempio comune: sezioni con un nome, ognuna con impostazioni o liste.

<?php
$config = [
    'db' => [
        'host' => 'localhost',
        'port' => 3306,
    ],
    'admins' => ['ada', 'grace'],
    'features' => [
        'search' => ['enabled' => true, 'limit' => 20],
    ],
];

echo $config['db']['host'], "\n";
echo $config['admins'][1], "\n";
echo $config['features']['search']['limit'], "\n";

Aggiungere righe e valori annidati

$rows[] = [...] accoda una riga intera. $arr['key'][] = $value accoda dentro una lista annidata, e PHP crea l'array interno la prima volta, quindi raggruppare valori non richiede preparazione.

<?php
$orders = [
    ['customer' => 'Ada',   'item' => 'book'],
    ['customer' => 'Linus', 'item' => 'pen'],
    ['customer' => 'Ada',   'item' => 'lamp'],
];

$orders[] = ['customer' => 'Grace', 'item' => 'mug'];   // add a row

$byCustomer = [];
foreach ($orders as $order) {
    $byCustomer[$order['customer']][] = $order['item'];  // inner array created on first use
}

print_r($byCustomer);

Scorrere un array multidimensionale

Usa un foreach per livello. Per una lista di record di solito basta un ciclo, perché leggi i campi per nome. Per una griglia, il ciclo interno percorre le celle di ogni riga.

<?php
$students = [
    ['name' => 'Ada',   'scores' => [90, 85, 99]],
    ['name' => 'Linus', 'scores' => [70, 88, 79]],
];

foreach ($students as $student) {
    $average = array_sum($student['scores']) / count($student['scores']);
    echo $student['name'], ": ", round($average, 1), "\n";
}

$grid = [[1, 2, 3], [4, 5, 6]];
foreach ($grid as $r => $row) {
    foreach ($row as $c => $cell) {
        echo "[$r][$c]=$cell ";
    }
    echo "\n";
}

Costruire una tabella HTML da un array

Un array di righe corrisponde direttamente a una tabella HTML: le chiavi della prima riga diventano l'intestazione, e ogni riga diventa un <tr>. Eseguilo e la scheda Page mostra la tabella; cambia un valore o aggiungi una riga ed esegui di nuovo.

<?php
$products = [
    ['name' => 'Keyboard', 'price' => 49.99, 'stock' => 12],
    ['name' => 'Mouse',    'price' => 19.50, 'stock' => 0],
    ['name' => 'Monitor',  'price' => 189.00, 'stock' => 4],
];
?>
<style>
  table { border-collapse: collapse; font-family: sans-serif; }
  th, td { border: 1px solid #ccc; padding: 6px 12px; text-align: left; }
  .out { color: #b00; }
</style>
<table>
  <tr>
    <?php foreach (array_keys($products[0]) as $heading): ?>
      <th><?= htmlspecialchars(ucfirst($heading)) ?></th>
    <?php endforeach; ?>
  </tr>
  <?php foreach ($products as $product): ?>
    <tr class="<?= $product['stock'] === 0 ? 'out' : '' ?>">
      <td><?= htmlspecialchars($product['name']) ?></td>
      <td><?= number_format($product['price'], 2) ?></td>
      <td><?= $product['stock'] ?></td>
    </tr>
  <?php endforeach; ?>
</table>

La forma foreach (...): ... endforeach; è lo stesso ciclo scritto per i template, così l'HTML resta leggibile.

Ottenere una colonna da tutte le righe

array_column() estrae un campo da ogni riga in una lista piatta. Passa un terzo argomento per usare un altro campo come chiave del risultato, il che trasforma una lista di record in una tabella di ricerca.

<?php
$users = [
    ['id' => 3, 'name' => 'Ada',   'email' => 'ada@example.com'],
    ['id' => 7, 'name' => 'Linus', 'email' => 'linus@example.com'],
    ['id' => 9, 'name' => 'Grace', 'email' => 'grace@example.com'],
];

print_r(array_column($users, 'name'));
print_r(array_column($users, 'email', 'id'));   // id => email

$byId = array_column($users, null, 'id');       // id => whole row
echo $byId[7]['name'], "\n";

Ordinare le righe per un campo

usort() ordina le righe con una funzione di confronto. L'operatore spaceship <=> restituisce -1, 0 o 1, esattamente ciò che usort() si aspetta. Scambia $a e $b per l'ordine decrescente.

<?php
$players = [
    ['name' => 'Ada',   'points' => 120],
    ['name' => 'Linus', 'points' => 95],
    ['name' => 'Grace', 'points' => 140],
];

usort($players, fn($a, $b) => $b['points'] <=> $a['points']);   // highest first

foreach ($players as $rank => $player) {
    echo $rank + 1, ". {$player['name']} ({$player['points']})\n";
}

echo count($players), " rows, ", count($players, COUNT_RECURSIVE), " elements in total\n";

count($players, COUNT_RECURSIVE) conta le 3 righe più i 6 campi al loro interno, ed è per questo che stampa 9.

Errore comune: leggere una chiave profonda che potrebbe mancare

Leggere $config['cache']['ttl'] quando non c'è la chiave cache stampa Warning: Undefined array key "cache", seguito da Warning: Trying to access array offset on null per il livello successivo. L'operatore ?? controlla l'intera catena in una volta e non genera mai warning, quindi è il modo sicuro di leggere valori annidati facoltativi.

<?php
$config = ['db' => ['host' => 'localhost']];

$ttl  = $config['cache']['ttl'] ?? 60;          // missing at the first level
$port = $config['db']['port'] ?? 3306;          // missing at the second level
$host = $config['db']['host'] ?? '127.0.0.1';   // present

echo "$ttl $port $host\n";
var_dump(isset($config['db']['host']));