PHP Fatal Error: Allowed Memory Size — desmistificando e configurando

Introdução: por que seu script PHP «explode»?

Você já viu uma tela branca com a mensagem arrepiante «Fatal Error: Allowed Memory Size of 134217728 Bytes Exhausted»? Se sim — você não está sozinho. Esta pergunta no Stack Overflow acumulou milhares de visualizações, e praticamente todo desenvolvedor PHP já se deparou com ela pelo menos uma vez na vida.

O número 134217728 bytes equivale exatamente a 128 megabytes (o limite padrão para muitas hospedagens). Quando seu script tenta usar mais — o PHP diz «pare» e lança um erro fatal. Mas não entre em pânico! Neste artigo, vamos entender por que isso acontece, como corrigir e — o mais importante — como otimizar o desempenho para que o erro de memória não o incomode mais.

O artigo foi escrito para o site educacional PythonLib, mas todo o código e exemplos são em PHP. Vamos lá!

O que é memory_limit e de onde vem o «134217728»?

No PHP, existe a diretiva memory_limit, que define a quantidade máxima de memória disponível para um único script. Por padrão, em muitas configurações (especialmente em hospedagens compartilhadas), o valor é 128M (ou 134217728 bytes).

Você pode verificar o limite atual assim:

<?php\necho ini_get('memory_limit'); // Exibirá, por exemplo, "128M"\n?>

Quando seu script ultrapassa esse limite — o PHP encerra imediatamente a execução com um erro fatal. As causas podem variar: desde código ineficiente até o carregamento de arquivos enormes na memória.

Cenários típicos que causam o erro

\n
• Trabalho com grandes arrays — por exemplo, ler um arquivo CSV inteiro na memória.
\n
• Loops com vazamentos — você esqueceu de liberar variáveis ou está usando arrays globais.
\n
• Bibliotecas de processamento de imagens — GD ou Imagick ao trabalhar com fotos de alta resolução.
\n
• Funções recursivas — sem uma condição de base, entram em loop infinito e consomem a pilha.
\n
• ORM e cache — alguns ORMs (como Doctrine) podem carregar toda a tabela na memória.
\n

Como corrigir o erro: 3 métodos comprovados

1. Aumento temporário do limite com ini_set()

A maneira mais rápida é aumentar o limite diretamente no script:

<?php\nini_set('memory_limit', '256M');\n// Agora o script pode usar até 256 MB\n?>

Importante: isso só funciona se sua hospedagem permitir a sobrescrita da diretiva. Em algumas hospedagens, o ini_set() para memory_limit é bloqueado.

2. Alteração do php.ini ou .htaccess

Se você tiver acesso ao servidor, edite o php.ini:

memory_limit = 256M

Ou via .htaccess (no Apache):

php_value memory_limit 256M

Após as alterações, reinicie o servidor web ou o PHP-FPM.

3. Otimização do código — a melhor solução

Aumentar o limite é uma gambiarra. A verdadeira solução é escrever um código eficiente. Vamos analisar exemplos.

Exemplo real: processamento de um grande arquivo CSV

Suponha que você tenha um arquivo CSV com 500.000 linhas. Um código ingênuo pode ser assim:

<?php\n$rows = file('data.csv'); // Carrega o arquivo INTEIRO na memória!\nforeach ($rows as $row) {\n    // processamento\n}\n?>

Com um arquivo de 200 MB — o script falhará com erro de memória.

Otimização: leitura linha por linha

<?php\n$handle = fopen('data.csv', 'r');\nif ($handle) {\n    while (($row = fgetcsv($handle)) !== false) {\n        // processa uma linha de cada vez\n        // a memória quase não aumenta\n    }\n    fclose($handle);\n}\n?>

Agora o script usa apenas alguns megabytes, independentemente do tamanho do arquivo.