Arrays en PHP: crear, acceder, recorrer e imprimir

Un array en PHP guarda una lista de valores bajo claves. Créalo con corchetes, $fruits = ['apple', 'banana', 'cherry'];, y lee un elemento por su índice, $fruits[0]. Los índices empiezan en 0, y count($fruits) da el número de elementos.

<?php
$fruits = ['apple', 'banana', 'cherry'];

echo $fruits[0], "\n";        // first element
echo $fruits[2], "\n";        // third element
echo count($fruits), "\n";    // number of elements

$fruits[] = 'date';           // add to the end
$fruits[1] = 'blueberry';     // change an element

print_r($fruits);

Todo array de PHP es un mapa ordenado: cada valor está bajo una clave. Cuando no eliges las claves, PHP las numera 0, 1, 2... y obtienes un array indexado. Cuando las eliges tú (['name' => 'Ada']), obtienes un array asociativo. Los dos son el mismo tipo array.

Crear un array

Los corchetes son la sintaxis habitual. array() es la forma antigua y produce exactamente lo mismo. range() construye una lista de números o letras, y array_fill() repite un valor.

<?php
$empty   = [];
$numbers = [10, 20, 30];
$old     = array('a', 'b', 'c');      // same as ['a', 'b', 'c']
$mixed   = [1, 'two', 3.5, true, null];

$oneToFive = range(1, 5);
$letters   = range('a', 'e');
$zeros     = array_fill(0, 3, 0);

echo implode(', ', $oneToFive), "\n";
echo implode(', ', $letters), "\n";
echo implode(', ', $zeros), "\n";
var_dump($empty === []);
echo count($mixed), "\n";

Un array de PHP puede contener a la vez valores de tipos distintos, incluidos otros arrays. Un array de arrays es un array multidimensional, la forma habitual de guardar filas de datos.

Obtener el primer y el último elemento

PHP no tiene índices negativos. $arr[-1] no significa "el último": busca una clave llamada -1 y, si no existe, PHP imprime Warning: Undefined array key -1. Usa array_key_first() y array_key_last(), que también funcionan cuando las claves no empiezan en 0.

<?php
$queue = ['Ada', 'Grace', 'Linus', 'Margaret'];

$first = $queue[array_key_first($queue)];
$last  = $queue[array_key_last($queue)];
echo "First: $first, last: $last\n";

// Same result by position
echo $queue[count($queue) - 1], "\n";

// The last two elements
print_r(array_slice($queue, -2));

end($queue) también devuelve el último valor, pero como efecto secundario mueve el puntero interno del array, así que la versión basada en claves es la opción más clara.

Imprimir un array

echo $arr no funciona: imprime la palabra Array y un warning. Elige la salida que encaje con lo que necesitas:

• print_r($arr) para un volcado legible mientras depuras.
• var_dump($arr) para ver además el tipo y la longitud de cada valor.
• implode(', ', $arr) para convertir los valores en una cadena que mostrar.
• json_encode($arr) para enviar el array a JavaScript o a una API.

<?php
$scores = [90, 72, 85];

print_r($scores);
var_dump($scores);
echo implode(', ', $scores), "\n";
echo json_encode($scores), "\n";

La página de print_r y var_dump explica las opciones de formato, incluido cómo imprimir un array dentro de HTML.

Recorrer un array

foreach es el bucle hecho para arrays: te da cada valor, y también la clave si la pides. Un bucle for con índice también sirve para arrays indexados cuyas claves van desde 0 sin huecos.

<?php
$languages = ['PHP', 'Python', 'Go'];

foreach ($languages as $language) {
    echo "I know $language\n";
}

foreach ($languages as $i => $language) {
    echo ($i + 1) . ". $language\n";
}

for ($i = 0; $i < count($languages); $i++) {
    echo strtolower($languages[$i]), "\n";
}

Los arrays se copian, no se comparten

Asignar un array a otra variable, o pasarlo a una función, da una copia. Cambiar la copia deja intacto el original. Añade & al parámetro cuando una función deba cambiar el array de quien la llama.

<?php
$a = [1, 2, 3];
$b = $a;          // a copy
$b[] = 4;

echo count($a), " ", count($b), "\n";

function addItem(array &$list, string $item): void
{
    $list[] = $item;
}

$cart = ['milk'];
addItem($cart, 'bread');
print_r($cart);

Funciones de arrays por tarea

PHP trae más de 70 funciones de arrays. Estas son las que más vas a usar, cada una con su propia página:

Claves que se fusionan sin avisar

Las claves de un array son enteros o cadenas, y PHP convierte algunas claves por ti. Una cadena que parece un número decimal entero, como "1", se convierte en el entero 1, así que $a["1"] y $a[1] son la misma posición. "01" y "1.5" se quedan como cadenas. Por eso un array construido con datos de un formulario o de un CSV puede acabar con menos elementos de los que esperabas.

<?php
$a = [];
$a[1]    = 'int one';
$a["1"]  = 'string one';   // same key as 1, overwrites it
$a["01"] = 'zero one';     // stays the string "01"

var_dump($a);
echo count($a), "\n";