Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

Percorrer um array por referência com `foreach`

Coloca `&` antes da variável do valor para alterar diretamente os elementos do array. Usa `unset($p)` após o ciclo para impedir que uma atribuição posterior altere o último elemento visitado.

Versão: PHP 8.3

Sintaxe

foreach ($projects as &$p) {
    // Modify the current array element through $p.
}
unset($p);

Em PHP 8.3, foreach ($projects as &$p) faz de $p um alias do elemento atual do array em cada iteração. Esta sintaxe faz parte da linguagem PHP e não requer nenhuma extensão opcional. Uma atribuição a $p substitui todo o elemento; uma atribuição a $p['status'] altera esse campo no array original $projects. Se também precisares da chave, usa foreach ($projects as $key => &$p): só o valor é associado por referência.

Se o ciclo visitou pelo menos um elemento, $p continua a ser um alias do último elemento visitado, mesmo após uma saída com break. Executa unset($p) logo após o ciclo para desfazer a associação sem eliminar o elemento do array. $p = null não desfaz a associação: escreve null nesse elemento.

Para ler os dados, usa foreach ($projects as $p) sem &. No array de registos do exemplo, atribuir um valor a $p sem uma associação por referência, ou a $p['status'], num ciclo por valor não altera $projects. No entanto, se omitires unset($p), um ciclo posterior por valor que reutilize $p pode sobrescrever o último elemento visitado ao fazer as suas atribuições.

Exemplos

<?php
$projects = [
    ['name' => 'Atlas', 'status' => 'draft'],
    ['name' => 'Beacon', 'status' => 'review'],
];

foreach ($projects as &$p) {
    if ($p['status'] === 'draft') {
        $p['status'] = 'ready';
    }
}
unset($p);

foreach ($projects as $p) {
    echo $p['name'], ': ', $p['status'], "\n";
}

Resultado

Atlas: ready
Beacon: review

O primeiro ciclo altera o estado de Atlas de `draft` para `ready`. Após `unset($p)`, o segundo ciclo reutiliza `$p` em segurança para apresentar os dois projetos; Beacon mantém o estado `review`.

Lições relacionadas

  • PHP · Lição 14 · Intermédio · Versão: 3
  • PHP · Lição 22 · Intermédio · Versão: 3

Fontes