O PHP é a linguagem que roda o WordPress no servidor. Sem ele, o site não carrega. Com a versão errada, o site pode funcionar mal, expor vulnerabilidades ou parar de funcionar quando plugins e temas atualizam.
Se você nunca verificou qual PHP seu site usa, ou recebeu um alerta da hospedagem sobre versão desatualizada, este guia cobre o processo completo: onde ver, como avaliar, como atualizar e o que testar depois — sem mudar às cegas e sem prometer milagre.
Antes de qualquer mudança de PHP: faça backup completo do site (arquivos e banco de dados) e, quando possível, teste primeiro em ambiente de staging. Se o site gera vendas, leads ou tem área de membros, não atualize diretamente em produção sem teste. Veja o guia de backup WordPress se ainda não tem uma rotina confiável.
O que é PHP e por que a versão importa
PHP é o motor server-side do WordPress. Quando alguém acessa seu site, o servidor executa código PHP para gerar a página HTML que o navegador exibe. Tudo — posts, páginas, WooCommerce, formulários, painel admin — depende de PHP.
Cada versão do PHP traz:
- Correções de segurança: vulnerabilidades descobertas são corrigidas nas versões ativas. Versões EOL (End of Life) não recebem mais patches.
- Melhorias de performance: versões mais recentes processam código mais rápido. A diferença de PHP 7.4 para PHP 8.x é significativa em benchmarks.
- Novas funcionalidades da linguagem: que plugins e temas modernos podem usar.
- Mudanças de comportamento: funções depreciadas podem ser removidas, o que quebra código antigo.
O ponto central: atualizar PHP é manutenção de segurança e performance, mas exige cuidado porque pode quebrar plugins ou temas que dependem de código legado.
Como verificar a versão do PHP no WordPress
Existem dois lugares para ver a versão do PHP: dentro do WordPress e no painel da hospedagem. Os dois importam.
Pelo Site Health do WordPress (painel admin)
Desde o WordPress 5.2, existe a ferramenta de Diagnóstico do site (Site Health).
- No painel do WordPress, vá em Ferramentas → Diagnóstico do site.
- Clique na aba Informações.
- Procure a seção Servidor.
- O campo Versão do PHP mostra qual versão o servidor está usando para rodar o WordPress.
Se a versão exibida for 7.4, 8.0 ou 8.1, seu site está rodando uma versão que já saiu de suporte oficial. Isso não significa que o site vai quebrar amanhã, mas significa que falhas de segurança descobertas a partir de agora não terão correção oficial.
Pelo WP-CLI (linha de comando)
Se você tem acesso SSH e o WP-CLI instalado, pode verificar rapidamente:
wp --infoO resultado mostra a versão do PHP que o WP-CLI está usando, além de outras informações do ambiente. Alternativamente, pode rodar diretamente:
php -vPara referência sobre WP-CLI em hospedagem, veja o guia sobre WP-CLI na Bluehost.
No painel da hospedagem
A versão do PHP que aparece no WordPress é a que o servidor está usando. Mas a configuração é feita no painel da hospedagem, não no wp-admin.
Cada provedor tem uma interface diferente:
- cPanel: procure “PHP Version”, “PHP Selector” ou “MultiPHP Manager” na seção Software.
- Plesk: vá em “PHP Settings” ou “Tools & Settings → PHP Settings”.
- Painel próprio do provedor: procure “PHP”, “Versão do PHP” ou “Configurações do servidor” nas configurações do site.
Se não encontrar, acione o suporte da hospedagem. Em alguns planos compartilhados, o administrador não tem acesso direto para mudar a versão — o provedor precisa fazer.
Para entender melhor como a hospedagem afeta essas configurações, veja o guia de hospedagem WordPress.
Tabela de compatibilidade: WordPress × PHP
Antes de atualizar o PHP, confirme se a sua versão do WordPress suporta a versão de PHP alvo. A tabela abaixo é baseada nos dados oficiais do WordPress Handbook (atualizada em agosto 2026).
| WordPress | PHP 8.5 | PHP 8.4 | PHP 8.3 | PHP 8.2 | PHP 8.1 | PHP 8.0 | PHP 7.4 | PHP 7.3 | PHP 7.2 |
|---|---|---|---|---|---|---|---|---|---|
| 7.1 | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Não | Não |
| 7.0 | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Não | Não |
| 6.9 | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Sim |
| 6.8 | — | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Sim |
| 6.7 | — | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Sim |
Observações importantes:
- WordPress 7.0 e 7.1 não suportam PHP 7.2 e 7.3 (suporte removido).
- WordPress 6.8 e 6.7 não suportam PHP 8.5 (compatibilidade ainda não adicionada).
- A tabela mostra compatibilidade do core. Plugins e temas podem ter requisitos diferentes.
- “Sim” significa que o core do WordPress funciona. Não garante que todos os plugins funcionem.
- Para versões mais antigas do WordPress, consulte a tabela completa no Handbook.
O que verificar antes de atualizar o PHP
Atualizar o PHP sem verificar a compatibilidade de plugins e temas é o erro mais comum — e o mais evitável.
1. Plugins ativos
Para cada plugin ativo no site:
- A página do plugin no WordPress.org informa compatibilidade com versões de PHP?
- O plugin recebe atualizações recentes? Plugin sem atualização há mais de 12 meses é sinal de alerta.
- O plugin é crítico para o site? (WooCommerce, formulário de contato, LMS, membership, cache, SEO).
- Há relatos de incompatibilidade com a versão de PHP alvo nos fóruns de suporte do plugin?
2. Tema ativo
- O tema está atualizado?
- Há customizações feitas diretamente nos arquivos do tema (sem tema filho)?
- O tema usa funções PHP que foram depreciadas na versão alvo?
3. Código customizado
Se o site tem snippets adicionados via plugin de código (como Code Snippets), functions.php personalizado ou integrações customizadas:
- Revise se algum código usa funções que foram removidas na versão de PHP alvo.
- Em caso de dúvida, consulte o guia de migração oficial do PHP (php.net/manual/migration84.php para 8.4, por exemplo).
4. Teste automatizado (WP-CLI)
Existe um comando WP-CLI para verificação de compatibilidade PHP (php-compat-command):
wp php-compatAtenção: esse comando faz uma varredura de código usando PHPCompatibility PHPCS, mas não é 100% preciso. Ele pode apontar falsos positivos e falsos negativos. Use como indicativo, não como garantia. Para instalá-lo, é necessário o WP-CLI v2 ou superior.
Checklist pré-atualização
Antes de mudar a versão do PHP:
- Backup completo feito (arquivos + banco de dados) e armazenado fora do servidor.
- Sabe como restaurar o backup se necessário.
- Versão atual de PHP documentada (anote para referência).
- Lista de plugins ativos conferida para compatibilidade.
- Tema ativo conferido para compatibilidade.
- Código customizado revisado.
- Ambiente de staging disponível (se a hospedagem oferecer).
- Horário de menor tráfego escolhido para a mudança.
- Contato do suporte da hospedagem à mão.
- Sabe onde mudar a versão de PHP no painel da hospedagem.
Se o site é uma loja WooCommerce, área de membros ou recebe formulários importantes, o staging não é opcional — é obrigatório. Veja o guia de staging WordPress para criar o ambiente de teste.
Como atualizar o PHP na hospedagem
O processo exato depende do provedor e do painel. A orientação abaixo é geral.
Passo a passo geral
- Acesse o painel da hospedagem (cPanel, Plesk ou painel próprio).
- Localize a configuração de PHP — pode estar em “PHP Version”, “PHP Selector”, “MultiPHP Manager”, “PHP Settings” ou seção equivalente.
- Anote a versão atual antes de mudar.
- Selecione a nova versão de PHP — se estiver no PHP 7.4 ou 8.0, o alvo recomendado é PHP 8.3 ou 8.4 (versões com security support ativo em setembro 2026).
- Confirme a mudança e aguarde o servidor aplicar.
- Acesse o site imediatamente para verificar se carrega.
Dicas
- Faça a mudança no staging primeiro se a hospedagem permitir configurar PHP separadamente por ambiente.
- Não atualize de PHP 7.4 direto para 8.5 se o site tiver plugins antigos. Considere pular para 8.3 primeiro, testar e depois subir se necessário.
- Em hospedagem compartilhada, a mudança pode levar alguns minutos para propagar.
- Se usar LiteSpeed, Nginx ou Apache com PHP-FPM, o reinício do serviço pode ser automático ou pode exigir ação do provedor.
O que testar depois da atualização
Não basta olhar a homepage por 3 segundos. Depois de mudar o PHP, teste:
- Homepage carrega normalmente.
- Posts e páginas principais abrem sem erro.
- Painel do WordPress (wp-admin) funciona — login, navegação, editor.
- Formulários de contato enviam e recebem mensagens.
- Checkout do WooCommerce (se houver loja) — simule uma compra completa.
- Área de membros ou login de usuários (se aplicável).
- Busca interna funciona.
- Imagens e uploads carregam.
- Cache foi limpo após a mudança.
- Logs de erro do servidor não mostram novos warnings ou fatals.
Para verificar logs de erro, acesse o arquivo de log do servidor (geralmente em /var/log/ ou no painel da hospedagem) ou ative o debug do WordPress adicionando define('WP_DEBUG_LOG', true); no wp-config.php.
E se quebrar? Como reverter
Se o site quebrar após atualizar o PHP — tela branca, erro fatal, formulário parou, checkout com erro — o primeiro passo é manter a calma e não sair atualizando tudo.
Reverter a versão do PHP
- Volte ao painel da hospedagem.
- Mude a versão de PHP de volta para a anterior (por isso anotamos antes).
- Aguarde a propagação e acesse o site.
A reversão de PHP costuma ser imediata, mas pode levar alguns minutos dependendo da hospedagem e do tipo de PHP (CGI, FPM, etc.).
Se a reversão não resolver
- Verifique se o cache do servidor ou do plugin não está servindo páginas com erro.
- Limpe todo o cache: plugin, hospedagem, CDN, navegador.
- Acesse o log de erros do servidor para identificar o problema específico.
- Se o erro mencionar um plugin ou tema específico, desative-o e teste novamente.
- Se não conseguir acessar o painel, desative plugins via FTP/SSH renomeando a pasta
wp-content/plugins. - Acione o suporte da hospedagem se o erro persistir.
Cuidado com reversão parcial
Se o site usou código novo (plugin atualizado que exige PHP 8.x, por exemplo) e gerou dados no banco de dados, reverter o PHP pode não ser suficiente. O banco pode ter dados ou estruturas que o código antigo não reconhece. Nesses casos, pode ser necessário restaurar o backup.
Por isso o backup antes da mudança é essencial — ele é a sua rota de volta real.
PHP 7.4, 8.0 e 8.1: por que “funciona” não é suficiente
Muitos sites ainda rodam em PHP 7.4, 8.0 ou 8.1 e funcionam normalmente. Mas funcionar e ser seguro são coisas diferentes.
PHP 7.4 — EOL desde novembro 2022
O PHP 7.4 saiu de suporte ativo e de segurança em novembro de 2022. Isso significa quase 4 anos sem correções oficiais. Vulnerabilidades descobertas após essa data não têm patches. Se a hospedagem ainda oferece PHP 7.4, é por compatibilidade, não por segurança.
O WordPress 7.1 ainda suporta PHP 7.4, mas “suporta” significa “funciona tecnicamente”, não “é recomendado”.
PHP 8.0 — EOL desde novembro 2024
PHP 8.0 saiu de suporte de segurança em novembro de 2024. Quase 2 anos sem patches.
PHP 8.1 — EOL desde dezembro 2025
PHP 8.1 saiu de suporte de segurança em dezembro de 2025. Menos tempo sem patches, mas já é oficialmente aposentado.
O que “sem suporte” significa na prática
- Se uma vulnerabilidade for descoberta em PHP 8.1, não haverá correção oficial.
- A hospedagem pode aplicar patches próprios (backports), mas isso depende do provedor e não é garantido.
- Plugins e temas modernos vão parar de testar e garantir compatibilidade com versões EOL.
- O WordPress pode eventualmente remover suporte para versões muito antigas.
Recomendação: se o site está em PHP 7.4, 8.0 ou 8.1, planeje a atualização para PHP 8.3 ou 8.4 (versões com security support ativo em setembro 2026). Não é urgência de “faça agora ou o site cai”, mas é uma dívida técnica que precisa ser resolvida.
Quando não atualizar (e o que fazer nesse caso)
Existem situações em que atualizar o PHP imediatamente não é viável:
- Plugin crítico sem atualização compatível. Se o WooCommerce, plugin de pagamento ou LMS não é compatível com PHP 8.x, atualizar o PHP pode quebrar funcionalidades essenciais. Nesse caso: pressione o desenvolvedor do plugin, busque alternativa compatível ou planeje migração.
- Tema muito antigo sem atualização. Se o tema não recebe atualizações e usa código PHP legado, a atualização pode quebrar o layout. Considere migrar para um tema mantido.
- Código customizado extenso sem documentação. Se há muito código adicionado por desenvolvedores anteriores e ninguém sabe o que faz, a revisão é mais complexa. Considere contratar análise técnica antes de mudar.
- Hospedagem que não permite mudar PHP. Em alguns planos compartilhados muito básicos, o provedor controla a versão e não oferece opção. Nesse caso, avalie migrar para uma hospedagem com mais controle.
Importante: “não atualizar agora” não é o mesmo que “nunca atualizar”. Se o site não pode mudar de PHP hoje, planeje a atualização. Quanto mais tempo rodando em PHP sem suporte, maior o risco acumulado.
Checklist final
- Versão de PHP atual verificada (Site Health e painel da hospedagem).
- Tabela de compatibilidade WordPress × PHP consultada.
- Plugins ativos verificados para compatibilidade.
- Tema ativo verificado para compatibilidade.
- Código customizado revisado.
- Backup completo feito e armazenado fora do servidor.
- Ambiente de staging testado (quando disponível).
- PHP atualizado no painel da hospedagem.
- Site testado completamente após atualização.
- Cache limpo após a mudança.
- Logs de erros verificados.
- Monitoramento nas horas seguintes.
Conclusão
A versão do PHP é uma das peças mais importantes — e mais esquecidas — da manutenção do WordPress. Ela afeta segurança, performance e compatibilidade com plugins e temas.
Verificar qual PHP o site usa leva menos de um minuto pelo Site Health. Se estiver desatualizado, o processo de atualização exige método: verificar compatibilidade, fazer backup, testar em staging e só então aplicar em produção.
PHP 7.4, 8.0 e 8.1 já saíram de suporte oficial. Isso não significa que o site vai parar hoje, mas significa que vulnerabilidades futuras não terão correção. Planejar a atualização para PHP 8.3 ou 8.4 é manutenção básica — não luxo.
Para aprofundar outros pontos de manutenção, veja os guias sobre atualizar WordPress com segurança, staging WordPress e backup WordPress.
