Como atualizar a versão do PHP no WordPress com segurança
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.
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.
// 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?
Qual versão do PHP devo usar no WordPress?
Onde troco a versão do PHP?
O site quebrou depois de atualizar o PHP. Como volto?
Preciso editar algum arquivo para atualizar o PHP?
Como sei se meus plugins são compatíveis com a versão nova?
Como corrigir a incompatibilidade do Tutor LMS com PHP 8.3
A incompatibilidade do Tutor LMS com PHP 8.3 acontece quando uma versão do plugin escrita para PHP 7.4 roda num servidor já no PHP 8.3, gerando avisos de Deprecated e, em alguns casos, erro fatal ao salvar cursos ou abrir o construtor de quiz. A documentação oficial homologa o plugin a partir do PHP 7.4.
Como corrigir Uncaught Error: Class not found
O erro Class not found é um erro fatal de PHP que aparece quando o código instancia uma classe que não foi carregada na execução. No WordPress, surge quando um plugin atualizado pela metade, um autoload do Composer ausente ou um arquivo de classe apagado impedem o PHP de encontrar a definição.
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.
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.
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.
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.
