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