Arrays em PHP: criar, acessar, percorrer e imprimir

Um array PHP guarda uma lista de valores sob chaves. Crie um com colchetes, $fruits = ['apple', 'banana', 'cherry'];, e leia um elemento pelo índice, $fruits[0]. Os índices começam em 0, e count($fruits) dá o 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 PHP é um mapa ordenado: cada valor fica sob uma chave. Quando você não escolhe as chaves, o PHP as numera 0, 1, 2... e você tem um array indexado. Quando você mesmo as escolhe (['name' => 'Ada']), tem um array associativo. Os dois são o mesmo tipo array.

Criar um array

Colchetes são a sintaxe comum. array() é a grafia antiga e produz exatamente a mesma coisa. range() monta uma lista de números ou letras, e array_fill() repete um 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";

Um array PHP pode guardar valores de tipos diferentes ao mesmo tempo, incluindo outros arrays. Um array de arrays é um array multidimensional, o jeito comum de guardar linhas de dados.

Pegar o primeiro e o último elemento

O PHP não tem índices negativos. $arr[-1] não significa "o último": ele procura uma chave chamada -1 e, quando não há, o PHP imprime Warning: Undefined array key -1. Use array_key_first() e array_key_last(), que também funcionam quando as chaves não começam em 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) também retorna o último valor, mas move o ponteiro interno do array como efeito colateral, então a versão baseada na chave é a escolha mais clara.

Imprimir um array

echo $arr não funciona: imprime a palavra Array e um aviso. Escolha a saída que serve para o caso:

• print_r($arr) para uma saída legível durante a depuração.
• var_dump($arr) para ver também o tipo e o tamanho de cada valor.
• implode(', ', $arr) para transformar os valores numa string para exibir.
• json_encode($arr) para enviar o array ao JavaScript ou a uma API.

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

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

A página sobre print_r e var_dump explica as opções de formatação, incluindo como imprimir um array dentro do HTML.

Percorrer um array

O foreach é o loop feito para arrays: ele entrega cada valor, e também a chave se você pedir. Um laço for com índice também funciona para arrays indexados cujas chaves vão de 0 sem buracos.

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

Arrays são copiados, não compartilhados

Atribuir um array a outra variável, ou passá-lo para uma função, gera uma cópia. Alterar a cópia não mexe no original. Adicione & ao parâmetro quando uma função deve alterar o array de quem chamou.

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

Funções de array por tarefa

O PHP traz mais de 70 funções de array. Estas são as que você mais vai usar, cada uma com sua página:

Chaves que se fundem em silêncio

Chaves de array são inteiros ou strings, e o PHP converte algumas chaves para você. Uma string que parece um número decimal inteiro, como "1", vira o inteiro 1, então $a["1"] e $a[1] são a mesma posição. "01" e "1.5" continuam strings. É por isso que um array montado a partir de dados de formulário ou de um CSV pode acabar com menos elementos do que você esperava.

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