Geradores fornecem uma forma eficiente em memória de iterar sobre grandes conjuntos de dados, produzindo valores um de cada vez (preguiçosamente) usando a palavra-chave yield, em vez de construir um array inteiro na memória de uma só vez. Eles são ideais para dados grandes ou em streaming.
{
= [];
( = ; < ; ++) { [] = ; }
;
}
{
( = ; < ; ++) {
;
}
}
(() ) {
();
}
yield torna uma função um gerador: ela produz valores preguiçosamente, um por iteração, mantendo seu estado entre eles — então a memória permanece constante, independentemente de quantos valores produz.
function readLines(string $file): Generator {
$handle = fopen($file, 'r');
while (($line = fgets($handle)) !== false) {
yield $line; // yield one line at a time — never load the whole file
}
fclose($handle);
}
foreach (readLines('huge-10gb.csv') as $line) { // processes a 10GB file with tiny memory
process($line);
}
Ler um arquivo enorme linha por linha com um gerador usa memória constante — impossível com file() (que carrega o arquivo inteiro em um array).
function fetchRows(PDOStatement $stmt): Generator {
while ($row = $stmt->fetch()) {
yield $row['id'] => $row; // yield key => value, streaming DB rows
}
}
Geradores são ótimos para streaming de resultados de banco de dados — processar linhas uma de cada vez em vez de carregar um grande conjunto de resultados na memória.
Geradores são um recurso importante do PHP para processamento eficiente em memória de grandes conjuntos de dados — e compreendê-los é valioso para construir aplicações que lidam com dados em escala sem esgotar a memória.
O problema central que resolvem é que construir um array completo de dados grandes (milhões de registros, linhas de um arquivo enorme, um grande conjunto de resultados de banco de dados) pode consumir memória enorme e derrubar a aplicação, enquanto geradores produzem valores preguiçosamente, um de cada vez, mantendo a memória constante, independentemente do tamanho do conjunto de dados.
Os casos de uso mais impactantes são práticos e comuns: ler arquivos grandes linha por linha (processar um CSV ou log com vários gigabytes com memória mínima, impossível com funções que carregam tudo), streaming de resultados de banco de dados (lidar com grandes resultados de consulta linha por linha), e processar sequências grandes ou até infinitas.
Compreender yield, avaliação preguiçosa e quando recorrer a geradores (sempre que você construiria um array grande na memória) permite escrever código de processamento de dados escalável que lida com grandes volumes graciosamente — uma necessidade frequente no mundo real em jobs em lote, importações/exportações, geração de relatórios e pipelines de dados.
Embora não seja necessário para pequenos conjuntos de dados, geradores são conhecimento essencial para PHP consciente de memória que processa grandes quantidades de dados, diferenciando desenvolvedores que podem construir código escalável de manipulação de dados daqueles cujas aplicações falham ou desaceleram sob grandes cargas de trabalho, tornando-o conhecimento valioso em nível sênior para aplicações PHP sensíveis ao desempenho e intensivas em dados.