Atualizar PHP no WordPress: como fazer com segurança

Tipo Erro de PHP

Nome do erro Atualização da versão do PHP EN: PHP version update

Severidade Grave

Descrição Atualizar a versão do PHP do WordPress deixa o site mais rápido e seguro, mas plugins ou temas antigos podem quebrar na versão nova. O caminho seguro é testar em uma cópia, conferir a compatibilidade e só então trocar a versão no painel da hospedagem, com como reverter à mão.

O que é a atualização da versão do PHP?

Atualizar a versão do PHP no WordPress é trocar, no painel da hospedagem, a versão da linguagem que executa o site (por exemplo, do PHP 7.4 para o 8.2). O WordPress recomenda rodar sempre uma versão suportada do PHP, porque versões antigas perdem correções de segurança e são mais lentas. O risco é que plugins ou temas escritos para versões antigas disparem erros fatais na versão nova, por isso a troca pede teste prévio e um plano de reversão, não é só clicar e esquecer.

Como identificar

Aviso em Ferramentas > Saúde do site: “Seu site está executando uma versão desatualizada do PHP”, recomendando atualizar.
O painel da hospedagem oferece versões mais novas do PHP do que a que o site usa hoje.
Após uma atualização de PHP feita pelo host, um plugin antigo derruba o site com “Fatal error” ou avisos de “Deprecated”.
Plugins e temas pedem uma versão mínima do PHP maior do que a atual para instalar ou atualizar.

Antes de começar: Faça backup completo antes de trocar a versão e prefira testar em homologação. Nunca rode uma versão do PHP sem suporte só para manter um plugin antigo: o ganho de compatibilidade não compensa ficar sem correções de segurança. Se precisar de tempo, mantenha o plugin desativado em vez de travar o PHP em uma versão vulnerável.

Como prevenir

Acompanhe a aba Saúde do site e mantenha o PHP sempre em uma versão com suporte ativo
Mantenha plugins e tema atualizados, porque versões novas costumam acompanhar as exigências do PHP
Tenha backups automáticos e use o ambiente de homologação da hospedagem antes de cada troca de versão

Causa

Versão do PHP do plano abaixo da recomendada pelo WordPress, sem suporte de segurança ativo.
Plugin ou tema sem manutenção que usa funções removidas na versão nova do PHP e gera erro fatal.
Atualização do PHP aplicada direto em produção, sem testar antes em uma cópia de homologação.
Falta de backup antes da troca, deixando o site sem caminho de reversão se algo quebrar.
Dependência de uma extensão do PHP que não vem ativada por padrão na versão nova.

Como resolver

Faça backup completo do site: antes de qualquer coisa, gere um backup de arquivos e banco de dados. Se a troca quebrar algo, você restaura o estado anterior sem perda.
Atualize tudo e cheque a compatibilidade: atualize o core, os plugins e o tema para as versões mais recentes. Em Ferramentas > Saúde do site, veja a versão recomendada e os avisos de compatibilidade.
Teste em uma cópia (staging): se a hospedagem oferecer ambiente de homologação, clone o site e mude a versão do PHP só na cópia. Navegue pelas páginas principais e pelo wp-admin procurando erros.
Troque a versão no painel da hospedagem: no painel do host (cPanel, Plesk ou o painel próprio), abra o seletor de versão do PHP, escolha a versão suportada recomendada e salve. A troca é feita ali, sem editar arquivos.
Reverta a versão se o site quebrar: se aparecer erro fatal, volte para a versão anterior no mesmo seletor do painel. O site retorna na hora, e aí você atualiza ou troca o plugin culpado antes de tentar de novo.

PHP

// Snippet de diagnostico: descobre a versao do PHP que o site roda agora
// e avisa se esta abaixo do minimo recomendado. Cole no functions.php
// temporariamente, ou rode antes de planejar a troca.

$versao_atual = phpversion();
$minimo_recomendado = '8.1';

if ( version_compare( $versao_atual, $minimo_recomendado, '<' ) ) {
    error_log( 'PHP desatualizado: site roda ' . $versao_atual . ', recomendado ' . $minimo_recomendado . '+' );
}

Perguntas frequentes

Atualizar o PHP pode quebrar o meu site?

Pode, se um plugin ou tema antigo usar recursos removidos na versão nova. Por isso o caminho seguro é fazer backup, atualizar tudo, testar em uma cópia e só então trocar a versão, com a opção de reverter no painel se algo quebrar.

Qual versão do PHP devo usar no WordPress?

Use sempre uma versão com suporte ativo, como o PHP 8.1 ou superior, conforme a recomendação que aparece em Ferramentas > Saúde do site. Versões antigas perdem correções de segurança e deixam o site mais lento.

Onde troco a versão do PHP?

No painel da sua hospedagem. Em cPanel costuma ser MultiPHP Manager ou Select PHP Version; em Plesk e em painéis próprios há um seletor de versão do PHP por site. A troca é feita ali, sem editar arquivos do WordPress.

O site quebrou depois de atualizar o PHP. Como volto?

Volte para a versão anterior no mesmo seletor do painel da hospedagem: o site retorna na hora. Depois, identifique o plugin ou tema que disparou o erro fatal, atualize-o ou substitua-o, e só então tente a versão nova de novo.

Preciso editar algum arquivo para atualizar o PHP?

Não. A troca da versão é feita no painel da hospedagem. Você só mexe em arquivos se precisar reverter manualmente ou ajustar um plugin que ficou incompatível, mas a atualização em si não exige editar o WordPress.

Como sei se meus plugins são compatíveis com a versão nova?

Confira a versão de PHP testada na página de cada plugin e use a aba Saúde do site, que sinaliza incompatibilidades. O teste mais confiável é clonar o site em homologação, aplicar a versão nova ali e navegar procurando erros.

Atenção

Como corrigir Undefined array key no PHP 8 do WordPress

O Undefined array key é um aviso do PHP 8 que aparece quando o código tenta ler uma posição de um array que não existe, por exemplo um campo de formulário que não foi enviado. O site segue no ar, mas a mensagem aparece na tela ou enche o debug.log e indica que falta uma verificação no código.

Grave

Como corrigir Headers already sent no WordPress

O headers already sent é um erro de PHP que aparece quando o WordPress tenta enviar um cabeçalho HTTP (um redirecionamento, um cookie de login) depois que algum conteúdo já foi enviado ao navegador. A causa quase sempre é um espaço em branco ou um echo antes ou depois das tags do PHP em um arquivo como o wp-config.php ou o functions.php.

Grave

Como corrigir Cannot redeclare function

O erro Cannot redeclare function é um erro fatal de PHP que ocorre quando a mesma função é definida duas vezes na execução. No WordPress, costuma surgir ao colar um snippet repetido no functions.php ou ao ativar dois plugins que declaram uma função com o mesmo nome.

Grave

Como corrigir Out of memory no PHP do WordPress

O erro out of memory no PHP do WordPress acontece quando um processo tenta alocar mais memória do que o limite do PHP ou a RAM do servidor têm disponível, e a execução para na hora. Costuma ser disparado por loops, consultas gigantes ou processos concorrentes em um servidor pequeno.

Grave

Como corrigir Failed opening required no WordPress

O Failed opening required é um erro fatal de PHP que aparece quando o código manda incluir um arquivo (com require) que não existe no caminho informado, está com permissão negada ou foi apagado. O WordPress para na hora e a página não abre, geralmente após uma migração, uma atualização interrompida ou um plugin removido pela metade.

Grave

Como corrigir Allowed memory size exhausted

O erro allowed memory size exhausted é um erro fatal de PHP que aparece quando um script do WordPress tenta usar mais memória do que o limite definido no servidor. O resultado é uma página em branco ou um aviso de erro fatal, geralmente disparado por um plugin pesado, importação de dados ou limite memory_limit baixo demais.

Setores

Extensões

Integrações

Como atualizar a versão do PHP no WordPress com segurança

O que é a atualização da versão do PHP?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir Undefined array key no PHP 8 do WordPress

Como corrigir Headers already sent no WordPress

Como corrigir Cannot redeclare function

Como corrigir Out of memory no PHP do WordPress

Como corrigir Failed opening required no WordPress

Como corrigir Allowed memory size exhausted

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos