Como foreach realmente funciona em PHP: anatomia do loop

Introdução: foreach não é apenas açúcar sintático

Todo desenvolvedor PHP, do iniciante ao guru, usa foreach praticamente todos os dias. Ele parece tão simples e intuitivo: "percorra cada elemento do array". Mas você já se perguntou: como exatamente o PHP faz isso? Por que o mesmo foreach se comporta de maneira diferente com arrays e objetos? Por que modificar um array dentro do loop às vezes gera resultados inesperados?

A pergunta "How does PHP 'foreach' actually work?" no Stack Overflow acumulou dezenas de milhares de visualizações e centenas de votos. Não é por acaso: por trás desse operador aparentemente simples, existe um mecanismo complexo e elegante. Hoje vamos mergulhar no coração do PHP e analisar a anatomia do loop foreach passo a passo.

Ao final deste artigo, você não apenas entenderá como o foreach funciona, mas também aprenderá a evitar erros comuns que pegam até programadores experientes. Vamos nessa!

Capítulo 1: foreach e o ponteiro interno do array

Quando o PHP encontra a construção foreach ($array as $value), ele não simplesmente "percorre os índices". Por baixo dos panos, tudo depende do ponteiro interno do array (internal array pointer). É uma "setinha" invisível que aponta para o elemento atual.

Veja como esse processo funciona passo a passo:

\n
1. Reset do ponteiro. O PHP chama reset($array) — o ponteiro vai para o primeiro elemento.
\n
2. Leitura da chave e do valor. O elemento atual do array é obtido.
\n
3. Atribuição. O valor é copiado para a variável $value (se não houver &).
\n
4. Avanço do ponteiro. O PHP move o ponteiro para o próximo elemento.
\n
5. Repetição. As etapas 2 a 4 são executadas até o ponteiro atingir o final do array.
\n

No entanto, há um detalhe importante: o PHP cria uma cópia do array antes de iniciar a iteração! Vamos entender por que isso é necessário.

Exemplo: resetando o ponteiro dentro do loop

<?php\n$array = [10, 20, 30];\n\nforeach ($array as $value) {\n    echo "$value\\n";\n    // Tentamos resetar o ponteiro\n    reset($array);\n}\n// Saída: 10, 20, 30 — reset não afetou o foreach\n?>

Por que reset() não funcionou? Porque o foreach trabalha com uma cópia do ponteiro interno, não com o original. Isso foi feito de propósito para que modificar o array dentro do loop não quebre a iteração.

Capítulo 2: foreach por valor vs por referência

A fonte mais comum de confusão é a diferença entre foreach ($array as $value) e foreach ($array as &$value). Vamos esclarecer tudo.

foreach por valor: cópia a cada passo

Quando você escreve foreach ($array as $value), o PHP, a cada iteração, copia o valor atual do array para a variável $value. Isso significa que alterar $value não afeta o array original.

<?php\n$array = [1, 2, 3];\nforeach ($array as $value) {\n    $value *= 2; // Alteramos a cópia\n}\nprint_r($array);\n// Saída: [1, 2, 3] — o array não mudou\n?>

Vantagem: Seguro, os dados originais não são alterados.
\nDesvantagem: Se os elementos do array forem objetos grandes, a cópia pode ser custosa. Embora o PHP use copy-on-write, para arrays com objetos, apenas os identificadores (handles) são copiados, não os objetos em si.

foreach por referência: trabalhando com o original

A sintaxe foreach ($array as &$value) faz o PHP passar uma referência ao elemento, em vez de uma cópia. Agora, $value é um apelido (alias) para o elemento do array.

<?php\n$array = [1, 2, 3];\nforeach ($array as &$value) {\n    $value *= 2; // Altera o array original\n}\nprint_r($array);\n// Saída: [2, 4, 6] — o array foi modificado\n?>

Vantagem: Mais eficiente para modificar arrays grandes, pois evita cópias desnecessárias.
\nDesvantagem: Cuidado com o efeito colateral! Após o loop, a variável $value ainda mantém a referência ao último elemento. Isso pode causar bugs sutis se você reutilizar $value depois.

Armadilha clássica: referência persistente

<?php\n$array = [1, 2, 3];\nforeach ($array as &$value) {\n    // apenas percorrendo\n}\nunset($value); // SEMPRE destrua a referência após o uso!\n\n// Se você não usar unset(), qualquer atribuição a $value\n// modificará o último elemento do array\n?>

Sempre use unset($value) após um loop com referência para evitar dores de cabeça.

Capítulo 3: foreach com objetos

Quando você usa foreach em um objeto, o comportamento depende de uma interface especial: Iterator ou IteratorAggregate. Objetos que implementam essas interfaces podem ser percorridos como arrays.

Se o objeto não implementa nenhuma dessas interfaces, o PHP percorre as propriedades públicas do objeto por padrão.

<?php\nclass Usuario {\n    public $nome = 'João';\n    public $email = 'joao@exemplo.com';\n    private $senha = '123456';\n}\n\n$user = new Usuario();\nforeach ($user as $chave => $valor) {\n    echo \"$chave: $valor\\n\";\n}\n// Saída:\n// nome: João\n// email: joao@exemplo.com\n// (propriedades privadas não são incluídas)\n?>

Para controle total sobre a iteração, implemente a interface Iterator com os métodos current(), key(), next(), rewind() e valid().

Capítulo 4: Performance e boas práticas

Agora que você entende a anatomia do foreach, veja algumas dicas para escrever código mais eficiente:

\n
• Prefira foreach a for para arrays associativos ou quando a ordem dos elementos não importa. O foreach é otimizado internamente.
\n
• Evite modificar o array dentro do foreach a menos que seja absolutamente necessário. Se precisar, use referências com cuidado.
\n
• Para arrays muito grandes, considere usar geradores (yield) se você só precisa ler os dados, não armazená-los.
\n
• Sempre destrua referências com unset() após loops com &$value.
\n

Conclusão

O foreach do PHP é muito mais do que um simples "loop para arrays". Ele gerencia ponteiros internos, lida com cópias e referências, e se adapta a objetos de forma inteligente. Entender seu funcionamento interno ajuda a evitar bugs e a escrever código mais limpo e performático.

Agora é sua vez: abra seu editor, teste os exemplos e veja na prática como o foreach se comporta. E lembre-se: sempre destrua as referências após o uso!