CKTIS / PHP
Ciclo `foreach` por referência com `&$row`
Usa `&$row` para alterar diretamente os elementos do array e executa `unset($row)` após o ciclo para desfazer a ligação ao último elemento percorrido.
Versão: PHP 8.3
Sintaxe
// The array syntax shown here requires no optional extensions in PHP 8.3.
foreach ($rows as &$row) {
// Modify the current array element through $row.
}
unset($row);
// With a key:
foreach ($rows as $key => &$row) {
// $key is the current key; $row is the element reference.
}
unset($row);Em PHP 8.3, com foreach ($rows as &$row), $row torna-se um alias do elemento atual do array em cada iteração. Alterar $row['qty'] atualiza esse campo diretamente em $rows; atribuir um novo valor a $row substitui o elemento inteiro. Aqui, & estabelece uma ligação por referência e não é o operador AND bit a bit. Na forma $key => &$row, $key recebe a chave por valor.
Se o ciclo executou pelo menos uma iteração, $row continua a ser um alias do último elemento percorrido depois de o ciclo terminar. Executa unset($row) logo a seguir: isto desfaz a ligação sem apagar o elemento nem anular as alterações. Caso contrário, uma atribuição posterior a $row, mesmo em foreach ($rows as $row) sem &, pode sobrescrever esse elemento sem aviso.
Para ler linhas comuns representadas por arrays, usa foreach ($rows as $row) e certifica-te de que $row não é já uma referência. Nesta iteração por valor, uma atribuição a $row não substitui o elemento em $rows. A sintaxe para arrays aqui apresentada não requer extensões adicionais.
Exemplos
<?php
$rows = [
['item' => 'A', 'qty' => 2],
['item' => 'B', 'qty' => 5],
];
foreach ($rows as &$row) {
$row['qty'] += 1;
}
unset($row);
foreach ($rows as $row) {
echo $row['item'], ': ', $row['qty'], "\n";
}Resultado
A: 3 B: 6
O primeiro ciclo aumenta ambas as quantidades e o segundo lê as linhas atualizadas. Sem `unset($row)`, o segundo ciclo sobrescreveria a última linha e apresentaria `A: 3` duas vezes.
Lições relacionadas
- PHP · Lição 19 · Avançado · Versão: 2