WordPress memory limit: como resolver "Allowed memory size exhausted"

O erro "PHP Fatal error: Allowed memory size of X bytes exhausted" é um dos mais comuns em WordPress. A solução óbvia — aumentar o limite — nem sempre é a correta. Este guia explica como resolver corretamente e quando o problema real é outro.

O que causa o memory limit esgotado

Cada processo PHP tem um limite de memória RAM que pode usar. Quando um pedido excede esse limite, PHP termina com o erro fatal. Em WordPress, as causas mais comuns são:

• Plugin com memory leak: plugin que consome memória crescente sem a libertar — pode ser identificado por processo de eliminação
• Operação pesada: importação de dados, geração de PDF, redimensionamento de imagens — picos legítimos de uso de memória
• Limite demasiado baixo: alguns hostings definem 32MB ou 64MB, insuficiente para WordPress moderno com plugins
• Combinação de plugins: cada plugin individual é razoável mas o conjunto ultrapassa o limite
• Tema pesado: page builders como Elementor ou Divi têm uso de memória elevado

Verificar o memory limit atual

Antes de alterar, verifique o estado atual. Em WordPress, aceda a Tools → Site Health → Info → Server. Em alternativa, crie um ficheiro temporário info.php:

<?php phpinfo(); ?>

Procure por memory_limit. Existem dois valores relevantes:

• PHP memory_limit: limite máximo que o PHP permite
• WP_MEMORY_LIMIT: limite que o WordPress solicita ao PHP

O WordPress não pode exceder o limite do PHP — o WP_MEMORY_LIMIT apenas define quanto o WordPress pede, dentro do que PHP permite.

Como aumentar o memory limit — 4 métodos

Método 1: wp-config.php (recomendado para WordPress)

Adicione antes da linha /* That's all, stop editing! */:

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M'); // para operações admin

Método 2: php.ini

Se tiver acesso ao php.ini do servidor ou pode criar um na raiz do WordPress:

memory_limit = 256M

Método 3: .htaccess (Apache)

php_value memory_limit 256M

Método 4: via hosting/cPanel

Muitos hostings permitem alterar o memory_limit diretamente no cPanel em "Select PHP Version" ou "PHP Configuration". Esta é a abordagem mais correta pois altera a configuração ao nível do PHP, não apenas do WordPress.

Qual valor definir

• 64MB: mínimo aceitável para WordPress básico sem page builder
• 128MB: padrão WordPress recomendado pela documentação oficial
• 256MB: recomendado para WordPress com Elementor, WooCommerce ou muitos plugins
• 512MB: para operações pesadas no admin (importações, geração de relatórios)
• >512MB: problema de arquitetura — algo está errado, não aumente mais sem investigar

Quando aumentar o limite não é a resposta

Se o site precisar de mais de 256MB para funcionar normalmente (não para operações pontuais), há um problema mais profundo. Neste caso, investigue:

Identificar o plugin que consome mais memória

Instale o Query Monitor. Na secção "PHP Errors" e "Memory" pode ver quanto cada componente consome. Desative plugins um a um e meça o impacto.

Verificar se há memory leak

Um memory leak manifesta-se como consumo crescente de memória ao longo do tempo ou em operações repetidas. O Query Monitor ajuda a identificar. Normalmente é um plugin com bug que retém referências em memória.

Considerar otimização de base de dados

Consultas que retornam dados excessivos (sem LIMIT, sem paginação) podem consumir muita memória ao construir os resultados. O Query Monitor identifica consultas lentas e pesadas.

Memory limit no contexto de performance geral

O memory limit é apenas um dos parâmetros PHP relevantes para WordPress. Outros valores importantes a verificar:

• max_execution_time: tempo máximo de execução de um script (mínimo 60s para WordPress, 300s para WooCommerce com operações pesadas)
• upload_max_filesize e post_max_size: para upload de ficheiros grandes (imagens, imports)
• max_input_vars: para formulários com muitos campos ou menus grandes (>1000 recomendado)

Para uma análise completa de performance, veja o guia de WordPress lento: causas e diagnóstico.