Como atualizar o PHP na sua hospedagem WordPress

Executar uma versão desatualizada do PHP é um dos maiores erros de desempenho e segurança que você pode cometer com um site WordPress. O PHP é a linguagem que dá vida ao WordPress, e cada nova versão traz melhorias mensuráveis de velocidade, correções de segurança e novos recursos de linguagem dos quais plugins e temas dependem. Se a sua hospedagem ainda executa PHP 7.4 ou mesmo PHP 8.0, você está deixando desempenho na mesa e expondo seu site a vulnerabilidades conhecidas que nunca serão corrigidas.

Por que a sua versão do PHP é importante para o WordPress

O PHP não é apenas um detalhe de bastidores. Ele afeta diretamente a velocidade de carregamento das páginas, a quantidade de memória que o servidor utiliza e até mesmo se os seus plugins conseguem ser executados. Cada versão principal do PHP inclui otimizações internas no Zend Engine (o runtime que executa o código PHP), e essas otimizações se acumulam ao longo do tempo. Um site WordPress executando PHP 8.3 atenderá mais requisições por segundo, usará menos memória por requisição e responderá mais rápido do que o mesmo site em PHP 7.4.

Além do desempenho, há a questão da segurança. O PHP 7.4 atingiu o fim de vida útil oficial (EOL) em novembro de 2022. O PHP 8.0 atingiu o EOL em novembro de 2023. O PHP 8.1 atingiu o EOL em dezembro de 2025. Quando uma versão atinge o EOL, a equipe do PHP para de lançar correções de segurança por completo. Se uma vulnerabilidade crítica for descoberta em uma versão EOL, ela jamais será corrigida. Seu provedor de hospedagem pode aplicar alguns patches retroativamente, mas você não deve confiar nisso.

Comparação de versões do PHP: desempenho e recursos

Aqui está uma análise prática das principais versões do PHP que você encontrará em hospedagens WordPress:

PHP 7.4 (EOL em novembro de 2022): O último lançamento da linha PHP 7.x. Foi uma versão sólida em sua época, mas não possui propriedades tipadas, union types, fibers e os ganhos de desempenho do PHP 8.x. O WordPress 6.4+ recomenda oficialmente PHP 8.0 ou superior. Muitos plugins mais novos abandonaram totalmente o suporte ao PHP 7.4.
PHP 8.0 (EOL em novembro de 2023): Introduziu o compilador JIT (Just-In-Time), argumentos nomeados, union types, expressões match e operadores nullsafe. O compilador JIT não melhora drasticamente cargas de trabalho típicas do WordPress (que são limitadas por I/O em vez de CPU), mas as otimizações gerais do engine ainda entregam um ganho de velocidade de 5 a 10% em relação ao PHP 7.4.
PHP 8.1 (EOL em dezembro de 2025): Adicionou fibers (usadas por bibliotecas assíncronas mais recentes), enums, propriedades readonly e tipos de interseção. O núcleo do WordPress tem suporte completo. A maioria dos plugins bem mantidos funciona bem no 8.1.
PHP 8.2 (correções de segurança até dezembro de 2026): Introduziu classes readonly, depreciou propriedades dinâmicas (o que fez alguns plugins antigos lançarem avisos de depreciação) e melhorou o gerador de números aleatórios. Esta é uma boa versão alvo se você quer estabilidade com suporte de segurança contínuo.
PHP 8.3 (suporte ativo até dezembro de 2026, correções de segurança até dezembro de 2027): Adicionou constantes de classe tipadas, a função json_validate() e várias melhorias de desempenho. Esta é atualmente a versão recomendada para novas instalações WordPress, pois tem a maior janela de suporte restante e o melhor desempenho.

Benchmarks de desempenho: como os números realmente se comportam

Em benchmarks reais do WordPress (testados com uma instalação padrão do WooCommerce, 20 plugins ativos e um tema como o Astra), as diferenças entre as versões do PHP são significativas:

PHP 7.4: Atende cerca de 90 a 100 requisições por segundo, com um tempo médio de resposta de cerca de 250ms.
PHP 8.0: Atende cerca de 100 a 115 requisições por segundo, tempo médio de resposta em torno de 220ms.
PHP 8.1: Atende cerca de 110 a 120 requisições por segundo, tempo médio de resposta em torno de 210ms.
PHP 8.2: Atende cerca de 115 a 125 requisições por segundo, tempo médio de resposta em torno de 200ms.
PHP 8.3: Atende cerca de 120 a 135 requisições por segundo, tempo médio de resposta em torno de 190ms.

Esses números variam dependendo do ambiente de hospedagem, mas a tendência é consistente: cada versão do PHP é mensuravelmente mais rápida que sua antecessora. Atualizar do PHP 7.4 para o 8.3 normalmente proporciona uma melhoria de 25 a 35% nas requisições por segundo.

Antes de atualizar: a lista de verificação pré-upgrade

Crie um backup completo: Faça backup tanto do banco de dados quanto dos arquivos. Use o UpdraftPlus, BackWPup ou a ferramenta de backup integrada do seu provedor de hospedagem. Não pule esta etapa. Se algo der errado, você precisa conseguir restaurar seu site em minutos.
Verifique a compatibilidade dos plugins e temas: Instale o plugin "PHP Compatibility Checker" da WP Engine. Ele varre os arquivos dos seus plugins e tema procurando chamadas de função que foram depreciadas ou removidas em versões mais novas do PHP. Preste atenção a quaisquer resultados "ERROR", pois esses causarão erros fatais. Os resultados "WARNING" geralmente apenas disparam avisos de depreciação que não quebram a funcionalidade.
Revise os guias de migração do PHP: A documentação oficial do PHP publica guias de migração para cada versão (php.net/migration80, php.net/migration81, etc.). Eles listam cada mudança incompatível. Você não precisa ler o guia inteiro, mas dê uma olhada na seção "Backward Incompatible Changes".
Use um ambiente de staging: Se seu provedor de hospedagem oferece staging (Kinsta, WP Engine, SiteGround e a maioria dos hosts gerenciados oferecem), clone seu site de produção para o staging e teste o upgrade do PHP lá primeiro. Esta é a etapa mais importante para evitar tempo de inatividade.
Atualize todos os plugins e temas primeiro: Antes de mudar a versão do PHP, certifique-se de que cada plugin e tema esteja executando a versão mais recente. Os desenvolvedores lançam atualizações regularmente que adicionam compatibilidade com versões mais novas do PHP.

Como mudar a sua versão do PHP

Hospedagem cPanel (a maioria das hospedagens compartilhadas)

Faça login no painel do cPanel.
Procure por "Select PHP Version" (CloudLinux) ou "MultiPHP Manager" (cPanel nativo). O nome depende da configuração do seu provedor de hospedagem.
Se estiver usando o MultiPHP Manager, selecione seu domínio na lista, escolha a nova versão do PHP no menu suspenso e clique em "Apply".
Se estiver usando o Select PHP Version, você verá a versão atual no topo. Clique no menu suspenso, selecione a nova versão e confirme. Esta interface também permite habilitar ou desabilitar extensões individuais do PHP.

Hospedagem Plesk

Faça login no Plesk e navegue até Websites & Domains.
Clique no domínio que deseja atualizar.
Clique em PHP Settings (ou "PHP Version", dependendo da sua versão do Plesk).
Selecione a nova versão do PHP no menu suspenso e clique em "Apply" ou "OK".
O Plesk também permite que você configure as configurações do PHP (memory_limit, max_execution_time, etc.) na mesma página.

Hospedagem WordPress gerenciada

Hosts gerenciados normalmente facilitam a troca de versão do PHP:

Kinsta: Vá para Sites, selecione seu site, clique em Tools, encontre "PHP Engine" e selecione a nova versão.
WP Engine: Vá para Sites, selecione seu ambiente, clique em Overview e encontre a configuração de versão do PHP. A WP Engine também tem um PHP Compatibility Checker integrado em seu painel.
SiteGround: Vá para Site Tools, depois PHP Manager na seção Devs. Você pode definir a versão do PHP por pasta, se necessário.
Cloudways: Vá para Server Management, Settings & Packages, depois a aba Packages. Mude a versão do PHP lá (isso afeta o servidor inteiro).

Erros comuns após atualizar o PHP

Se seu site exibir erros após uma atualização do PHP, não entre em pânico. Aqui estão os problemas mais comuns e suas soluções:

Erro fatal: Uncaught Error (função não encontrada)

Isso acontece quando um plugin ou tema usa uma função PHP que foi removida na nova versão. Exemplos comuns incluem create_function() (removida no PHP 8.0), each() (removida no PHP 8.0) e funções mysql_* (removidas desde o PHP 7.0). A correção é atualizar o plugin ou tema que dispara o erro. Verifique a mensagem de erro para o caminho do arquivo e identificar qual plugin é responsável.

Avisos de depreciação enchendo seu log de erros

O PHP 8.2 depreciou propriedades dinâmicas (definir propriedades não declaradas em objetos), o que causou uma enxurrada de avisos de depreciação em muitos plugins antigos. Esses avisos não quebram seu site, mas podem deixá-lo lento se o registro de erros for verboso. Atualize os plugins afetados ou, se um plugin estiver abandonado, considere substituí-lo por uma alternativa.

Tela branca da morte

Uma página completamente em branco geralmente significa que um erro fatal está ocorrendo, mas a exibição de erros está desativada. Habilite a exibição de erros temporariamente adicionando isto ao seu wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
define('WP_DEBUG_LOG', true);

Verifique o erro, corrija-o e, em seguida, desabilite o modo de depuração novamente em produção.

Erros de tipo e verificação de tipo mais rigorosa

O PHP 8.x é mais rigoroso quanto ao tratamento de tipos. Passar null para funções internas que esperam uma string (como strlen(null)) agora dispara um aviso de depreciação ou um TypeError. Isso geralmente aparece em plugins mal codificados que não verificam valores nulos antes de passá-los para funções de string.

Configurações essenciais do php.ini para o WordPress

Após atualizar o PHP, revise estas configurações importantes do php.ini. Você normalmente pode editá-las pelo painel de controle da sua hospedagem ou criando um arquivo php.ini ou .user.ini personalizado no diretório raiz do WordPress:

; Limite de memória - WordPress recomenda pelo menos 256M
memory_limit = 256M

; Tamanho máximo de upload
upload_max_filesize = 64M
post_max_size = 64M

; Tempo de execução - aumente se você tiver importações lentas ou operações grandes
max_execution_time = 300

; Variáveis de entrada - aumente se você tiver formulários complexos ou muitos campos personalizados
max_input_vars = 3000

; Relatório de erros - desative display_errors em produção
display_errors = Off
log_errors = On
error_log = /path/to/php-error.log

Configuração do OPcache para o melhor desempenho

O OPcache armazena bytecode PHP pré-compilado em memória compartilhada, de modo que o engine PHP não precise analisar e compilar os mesmos scripts a cada requisição. Ele vem habilitado por padrão na maioria dos provedores de hospedagem, mas as configurações padrão geralmente são muito conservadoras para o WordPress. Aqui estão as configurações recomendadas do OPcache:

opcache.enable = 1
opcache.memory_consumption = 256
opcache.interned_strings_buffer = 16
opcache.max_accelerated_files = 10000
opcache.revalidate_freq = 60
opcache.validate_timestamps = 1
opcache.save_comments = 1
opcache.enable_file_override = 1

A configuração opcache.max_accelerated_files deve ser maior que o número total de arquivos PHP em sua instalação WordPress. Um site WordPress típico com 20 plugins tem cerca de 5.000 a 8.000 arquivos PHP. Definir isso para 10.000 fornece margem. O opcache.revalidate_freq controla com que frequência o OPcache verifica se os arquivos de origem foram alterados. Em produção, 60 segundos é um bom equilíbrio. Defina como 0 em ambientes de desenvolvimento para que as alterações sejam detectadas imediatamente.

Como verificar qual versão do PHP seus plugins exigem

Nem todos os plugins declaram a versão mínima do PHP, mas os bons o fazem. Veja como verificar:

Página do plugin no WordPress.org: Role para baixo até o campo "Requires PHP" na barra lateral. Se o plugin lista "7.4" e você está no 8.3, deve ficar tudo bem na maioria dos casos, pois isso indica o mínimo, não o máximo.
readme.txt do plugin: Abra o arquivo readme.txt do plugin (em wp-content/plugins/plugin-name/readme.txt) e procure pelo cabeçalho "Requires PHP".
Código-fonte do plugin: O arquivo principal do plugin (aquele com o cabeçalho Plugin Name) às vezes inclui um comentário de cabeçalho "Requires PHP" que o WordPress lê.
Changelog e notas de versão: Verifique o changelog do plugin em busca de menções aos requisitos de versão do PHP, especialmente se você estiver atualizando várias versões principais.

Procedimento de rollback se algo quebrar

Se o seu site quebrar após uma atualização do PHP e você não conseguir resolver o problema rapidamente, faça o rollback para a versão anterior do PHP imediatamente. Aqui está o procedimento:

Mude a versão do PHP de volta: Use o mesmo método do cPanel, Plesk ou painel de hospedagem que você usou para atualizar. A troca de volta tem efeito em segundos na maioria dos hosts.
Verifique se o seu site está funcionando: Carregue seu site em um navegador e verifique o painel administrativo. Tudo deve voltar ao normal.
Investigue o problema: Agora que seu site está estável novamente, analise os logs de erro para identificar o plugin ou tema problemático. Atualize-o ou encontre uma alternativa.
Tente novamente: Depois de resolver o problema de compatibilidade, tente o upgrade do PHP novamente, primeiro em staging, depois em produção.

Se você não conseguir fazer o rollback pelo painel da hospedagem (por exemplo, se estiver bloqueado fora do cPanel), normalmente pode entrar em contato com o suporte do seu provedor de hospedagem e eles mudarão a versão do PHP para você em minutos.

Após atualizar: verificação pós-upgrade

Visite a página inicial do seu site e várias páginas internas. Procure por problemas visuais, layouts quebrados ou mensagens de erro.
Teste a funcionalidade crítica: formulários de contato, checkout do WooCommerce (se aplicável), login e registro, busca e quaisquer recursos personalizados.
Verifique o painel administrativo do WordPress em busca de avisos de plugins ou notificações de atualização.
Abra wp-content/debug.log (se WP_DEBUG_LOG estiver habilitado) e procure por novos erros ou avisos de depreciação do PHP.
Monitore o log de erros do PHP do seu servidor por pelo menos 24 a 48 horas. Alguns problemas só aparecem em condições específicas (certos templates de página, cron jobs, chamadas de API).
Limpe todos os caches (cache de página, cache de objetos, OPcache) para que sejam reconstruídos com a nova versão do PHP.

Verifique a sua versão do PHP com o InspectWP

Execute uma nova varredura do InspectWP após o upgrade. A seção de hospedagem exibe a versão do PHP detectada a partir dos cabeçalhos do servidor. Se a versão não mudou, seu provedor de hospedagem pode estar fazendo cache do antigo handler PHP. Limpe o cache do servidor, aguarde alguns minutos e faça a varredura novamente. O InspectWP também sinaliza versões desatualizadas do PHP na seção de segurança, para que você possa confirmar que o aviso foi resolvido após o upgrade.