Aumentando o Limite de Memória do WordPress

Quando o WordPress ou um plugin falha com um erro de esgotamento de memória, a solução é aumentar o limite de memória do PHP, e no Kapsule isso é um dropdown no KPanel em vez de uma edição de arquivo. Este guia abrange o que o erro significa, como alterar o limite, qual valor escolher e o que fazer quando mais memória não ajuda.

Qual é a Aparência do Erro

A forma mais clara é um erro fatal impresso na página ou escrito em seu registro de erros:

Fatal error: Allowed memory size of 268435456 bytes exhausted (tried to allocate 20480 bytes)

Divida o valor em bytes por 1.048.576 para lê-lo em megabytes: 268435456 é 256 MB, 134217728 é 128 MB.

Nem sempre se anuncia tão claramente. O mesmo problema subjacente aparece como:

• Uma página completamente em branco sem mensagem alguma, frequentemente em uma tela específica.
• O painel do WordPress carregando mas uma única página de administração (Plugins, Produtos, Integridade do Site) falhando.
• Um upload de mídia ou uma importação que progride parcialmente e para.
• Um erro 500 que aparece apenas sob carga.

Alterando o Limite no KPanel

1. Faça login em KPanel e clique em Websites na barra lateral esquerda.
2. Clique no site que deseja alterar.
3. No menu do site, abra Avançado, depois PHP.
4. Encontre o card PHP settings e a linha Memory limit.
5. Escolha um valor no dropdown: 128M, 256M, 512M, 1024M ou 2048M.
6. Clique em Save Settings.

Nenhuma reinicialização é necessária e o site permanece ativo durante todo o processo. Suas configurações são escritas em um arquivo .user.ini na raiz do seu site, que o KPanel gerencia para você.

O mesmo card controla outros quatro valores que frequentemente precisam ser ajustados junto com a memória:

Post max size não é mostrado porque Kapsule a define automaticamente, sempre 1 MB acima do seu limite de upload, então um formulário com um arquivo no limite ainda cabe.

Qual Valor Escolher

Todo site Kapsule começa em 256M, que já é o dobro do padrão do WordPress e suficiente para a grande maioria dos sites. Aumente apenas quando você tiver um erro real.

Definindo um Limite em wp-config.php

O dropdown do KPanel define o limite do servidor. O WordPress tem suas próprias duas constantes que solicitam memória até esse limite, e alguma documentação pode dizer para você configurá-las:

define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );

WP_MEMORY_LIMIT aplica-se ao front end. WP_MAX_MEMORY_LIMIT aplica-se à área de administração, que normalmente precisa de mais. Adicione-as acima da linha /* That's all, stop editing! */ em wp-config.php, usando o editor integrado em Files, depois File Manager, ou via SFTP.

Para a maioria das pessoas as constantes são desnecessárias. Defina o valor do KPanel e deixe wp-config.php como está.

Notas sobre WooCommerce

Lojas são o motivo mais comum para ir além de 256M. Verifique a visão da loja sobre o limite em WooCommerce, depois Status no wp-admin: o relatório System Status imprime o limite de memória do PHP que consegue ver, que é uma boa maneira de confirmar que sua alteração no KPanel realmente funcionou.

Aumente para 512M se você executar qualquer um destes:

• Produtos variáveis com dezenas de variações cada.
• WooCommerce Subscriptions ou uma extensão de reservas.
• Dois ou mais plugins de gateway de pagamento ativos ao mesmo tempo.
• Uma sincronização de inventário ou contabilidade que executa em segundo plano.

Páginas de administração do WooCommerce lentas ou com timeout são geralmente uma combinação de memória e tempo de execução. Aumente Max execution time para 120 segundos ao mesmo tempo e considere as opções de cache em Setting Up WooCommerce.

Verifique Sua Versão do PHP Também

Se erros de memória começaram logo após uma alteração de PHP, a própria versão pode estar envolvida: um plugin mais antigo pode vazar muito em um runtime mais novo. O card PHP version no topo da mesma guia mostra o que o site está executando e permite que você se mova entre PHP 8.4, 8.3, 8.2 e 8.1.

Alterar a versão reinicia o pool PHP do site, portanto, espere alguns segundos de downtime. O detalhe completo está em Changing Your PHP Version.

Quando Mais Memória Não Resolve

Aumentar o limite duas vezes sem melhora significa que algo está consumindo memória que não deveria. Trabalhe através disso em ordem:

1. Faça um backup. Taking a Backup primeiro, sempre.
2. Encontre o plugin. Desative plugins em metades em vez de um por vez: desligue metade, reteste, depois divida a metade que ainda falhar. Você também pode usar Plugin safe mode na guia WordPress, depois Plugins, que desativa todos os plugins de uma vez sem deletar nenhum dado do plugin.
3. Teste o tema. Mude para um tema padrão do WordPress temporariamente. Um tema executando consultas pesadas em cada carregamento de página produz exatamente este padrão.
4. Olhe para a operação, não para o site. Se apenas importações falham, o problema é tempo de execução e tamanho do lote, não memória. Importe em pedaços menores.
5. Leia o registro. O PHP error log na guia PHP nomeia o arquivo e a linha que ficou sem memória, o que geralmente identifica o plugin imediatamente.

Se você ainda estiver preso após 512M e um teste de plugin limpo, envie um email para support@kapsulehost.com com o domínio do site, a linha de erro fatal exata e o que você estava fazendo quando aconteceu.