Arrays multidimensionales en PHP: anidados y bucles

Un array multidimensional es un array cuyos elementos son arrays. Se lee con un par de corchetes por nivel: $grid[1][2] es la fila 1, columna 2, y $users[0]['name'] es el nombre del primer registro.

<?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 segunda forma, una lista de registros con campos con nombre, es la que más vas a encontrar: es lo que suelen darte una consulta a una base de datos, una respuesta JSON decodificada o un archivo CSV procesado. Cada registro es un array asociativo.

Crear arrays anidados

El anidamiento puede llegar tan hondo como necesites, y los niveles pueden mezclar claves numéricas y de texto. Un array de configuración es un ejemplo habitual: secciones con nombre, cada una con ajustes o listas.

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

Añadir filas y valores anidados

$rows[] = [...] añade una fila completa. $arr['key'][] = $value añade dentro de una lista anidada, y PHP crea el array interior la primera vez, así que agrupar valores no necesita preparación.

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

Recorrer un array multidimensional

Usa un foreach por nivel. Para una lista de registros, normalmente basta con un bucle porque lees los campos por su nombre. Para una cuadrícula, el bucle interior recorre las celdas de cada fila.

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

Generar una tabla HTML a partir de un array

Un array de filas se corresponde directamente con una tabla HTML: las claves de la primera fila se convierten en el encabezado y cada fila en un <tr>. Ejecútalo y la pestaña Página muestra la tabla renderizada; cambia un valor o añade una fila y vuelve a ejecutarlo.

<?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; es el mismo bucle escrito para plantillas, de modo que el HTML sigue siendo legible.

Obtener una columna de todas las filas

array_column() extrae un campo de cada fila en una lista plana. Pásale un tercer argumento para indexar el resultado por otro campo, lo que convierte una lista de registros en una tabla de búsqueda.

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

Ordenar filas por un campo

usort() ordena las filas con una función de comparación. El operador nave espacial <=> devuelve -1, 0 o 1, que es justo lo que espera usort(). Intercambia $a y $b para ordenar de forma descendente.

<?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) cuenta las 3 filas más los 6 campos que contienen, y por eso imprime 9.

Error frecuente: leer una clave profunda que puede faltar

Leer $config['cache']['ttl'] cuando no hay clave cache imprime Warning: Undefined array key "cache", seguido de Warning: Trying to access array offset on null para el siguiente nivel. El operador ?? comprueba toda la cadena de una vez y nunca avisa, así que es la forma segura de leer valores anidados opcionales.

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