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

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

Fontes