Atualizar versão do PHP: como trocar sem quebrar o site
Ciclo de suporte do PHP, o que o WordPress recomenda, cópia e teste antes da troca, PHP-FPM novo ao lado do antigo no Nginx ou Apache e o caminho de volta.
Por Redação Eleven Host · @robson.direitodigital · 19 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Atualizar versão do PHP: como trocar sem quebrar o site Arte: Eleven Host
Para atualizar versão do PHP sem quebrar o site, instale a versão nova ao lado da antiga, teste numa cópia, aponte o servidor web para o PHP novo e mantenha o caminho de volta pronto. Em 19/11/2026, o php.net lista 8.2, 8.3, 8.4 e 8.5 com suporte.
Pela tabela do php.net, cada ramo do PHP tem dois anos de suporte ativo e mais dois só de correções de segurança críticas. Em 19/11/2026, o 8.2 está na reta final: o suporte de segurança vai até 31/12/2026.
Por que atualizar a versão do PHP
O PHP é dividido em ramos, como 8.3 ou 8.4. Pela página de versões suportadas do php.net, cada ramo recebe dois anos de suporte ativo a partir do lançamento: nesse período, bugs e falhas de segurança relatados são corrigidos em versões pontuais regulares. Depois vêm mais dois anos só com correções de segurança críticas, lançadas conforme a necessidade. Ao fim dos quatro anos, o ramo chega ao fim da vida e deixa de ter suporte.
Para quem segue num ramo encerrado, o php.net diz que vale atualizar o quanto antes, porque o site pode ficar exposto a vulnerabilidades que não serão mais corrigidas.
Quais versões têm suporte em 19/11/2026
- PHP 8.5: lançado em 20/11/2025, suporte ativo até 31/12/2027 e de segurança até 31/12/2029.
- PHP 8.4: lançado em 21/11/2024, suporte ativo até 31/12/2026 e de segurança até 31/12/2028.
- PHP 8.3: lançado em 23/11/2023, só correções de segurança, até 31/12/2027.
- PHP 8.2: lançado em 08/12/2022, só correções de segurança, até 31/12/2026.
Pela página de fim da vida do php.net, o 8.1 deixou de ter suporte em 31/12/2025, o 8.0 em 26/11/2023 e o 7.4 em 28/11/2022.
O que o WordPress recomenda
A página de requisitos do WordPress.org, atualizada em 07/05/2026, recomenda PHP 8.3 ou mais novo. Ela diz que o WordPress ainda roda a partir do PHP 7.4, mas que essas versões antigas chegaram ao fim da vida oficial e podem expor o site a vulnerabilidades.
O manual de hospedagem do WordPress, atualizado em 16/11/2026, vai um passo além e recomenda PHP 8.4 ou mais novo para sites em produção. Pelo mesmo manual, o WordPress 7.1 exige pelo menos o PHP 7.4 e é compatível com as versões de 7.4 a 8.5; as de 7.4 a 8.1 seguem aceitas só por compatibilidade, e o manual recomenda com ênfase usar uma versão com suporte.
Como saber a versão atual do PHP
No terminal do servidor, o manual do PHP descreve três opções úteis da linha de comando:
php -vmostra o número da versão;php -mlista os módulos, ou extensões, carregados;php --inimostra quais arquivos de configuração foram lidos.
Um exemplo de comando, para guardar a lista de extensões num arquivo e comparar depois:
php -m > extensoes-antes.txt
Um detalhe que confunde: esses comandos mostram o PHP da linha de comando, e o site pode estar rodando outra versão pelo PHP-FPM. Recomendamos conferir também pelo próprio site.
No WordPress, a documentação aponta a tela Saúde do site, no painel em português em Ferramentas > Saúde do site. Na aba Status aparece o aviso de versão desatualizada do PHP, quando for o caso. Na aba Info, a seção Servidor mostra os dados do servidor e do PHP. A tela só informa: nada é alterado por ela.
Mais um caminho de infraestrutura é a VPS da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS
Antes de trocar: cópia, teste e lista de conferência
O próprio guia de migração do PHP 8.4 avisa que a versão traz algumas incompatibilidades que devem ser testadas antes de trocar a versão em produção. Recomendamos três cuidados antes de mexer no site no ar.
1. Faça cópia do site e do banco
Recomendamos copiar os arquivos do site e exportar o banco de dados antes da troca, e guardar a cópia fora da pasta do site. Uma forma de automatizar as cópias do servidor está em Restic na VPS: backup automático do servidor.
2. Teste numa cópia do site
Recomendamos testar a versão nova numa cópia do site, passando pelas páginas principais, formulários e área administrativa. No WordPress, num site WordPress, os dados de acesso ao banco ficam no arquivo de configuração, explicado em wp-config.php: o que é e como editar com segurança. Na cópia, aponte para um banco de teste, e não para o banco do site no ar.
3. Confira plugins, tema e o guia de migração
Cada plugin e tema pode informar as versões de PHP que aceita. Recomendamos conferir a página de cada um e atualizar o que estiver atrasado antes da troca.
O manual do PHP tem um guia de migração por versão (a tabela do php.net aponta um para cada ramo de 8.2 a 8.5); o do 8.4 tem seções de recursos novos, mudanças incompatíveis, recursos descontinuados e extensões removidas. As mudanças incompatíveis do 8.4 aparecem separadas por área, como o núcleo, MySQLi, PDO_MYSQL, DOM e SimpleXML.
Como trocar a versão do PHP numa VPS
Os passos abaixo valem para quem administra o próprio servidor; o básico desse tipo de servidor está em O que é servidor VPS: guia simples para iniciantes. Os comandos são exemplos montados para Ubuntu com PHP-FPM e podem pedir sudo. Confira nomes e caminhos no seu servidor antes de rodar.
Pelo manual do PHP, o FPM é a principal implementação FastCGI do PHP. A versão que atende o site é a do FPM cujo endereço está configurado no Nginx ou no Apache.
1. Veja qual versão o sistema oferece
Nos repositórios oficiais do Ubuntu, o pacote php-fpm corresponde ao php8.1-fpm no 22.04, ao php8.3-fpm no 24.04 e ao php8.5-fpm no 26.04. A versão disponível depende da versão do sistema.
2. Instale a versão nova ao lado da antiga
Recomendamos não remover a versão antiga nesta etapa: ela é o caminho de volta. Um exemplo de comando, trocando 8.5 pela versão que o seu sistema oferece:
apt install php8.5-fpm
Se a versão que o seu sistema oferece já estiver sem suporte, a troca pode pedir um sistema mais novo; confira a documentação da sua distribuição antes de seguir.
Extensões são instaladas por versão. Recomendamos comparar a lista salva em extensoes-antes.txt com a da versão nova e instalar as que faltarem antes de seguir.
3. Descubra o socket do PHP novo
Pelo manual do PHP, a diretiva listen de cada pool do FPM diz onde ele recebe os pedidos: um endereço com porta, só a porta ou o caminho de um socket unix. Um exemplo de comando, com o nome do arquivo do pool da versão nova:
grep '^listen' arquivo-do-pool.conf
Anote o caminho que aparece. Recomendamos conferir também se o serviço do PHP-FPM novo está rodando, por exemplo com systemctl status php8.5-fpm, trocando pelo nome do seu. Pelo manual do PHP, o FPM não deve ficar acessível a partir de uma rede não confiável.
4. Copie a configuração do site
Recomendamos copiar o arquivo de configuração do site antes de editar. Um exemplo de comando:
cp seusite.conf seusite.conf.bak
5. Aponte o servidor web para o socket novo
No Nginx, a diretiva fastcgi_pass define o endereço do servidor FastCGI e aceita o caminho de um socket unix. Um exemplo de linha, trocando o caminho pelo que você anotou:
fastcgi_pass unix:/caminho/do/socket-novo.sock;
No Apache 2.4.10 ou mais novo, a documentação do mod_proxy_fcgi mostra o PHP-FPM ligado por socket com SetHandler, e pede os módulos mod_proxy e mod_proxy_fcgi. Um exemplo, em que só o caminho do socket muda:
<FilesMatch "\.php$">
SetHandler "proxy:unix:/caminho/do/socket-novo.sock|fcgi://localhost/"
</FilesMatch>
6. Teste e recarregue
No Nginx, nginx -t testa a configuração e nginx -s reload recarrega; se a configuração nova falhar no reload, o Nginx segue com a anterior. No Apache, apachectl configtest confere a sintaxe e apachectl -k graceful reinicia sem derrubar conexões abertas. Recomendamos recarregar só se o teste passar:
nginx -t
nginx -s reload
Em seguida, volte ao Saúde do site e confira os dados do PHP na seção Servidor da aba Info.
Resumo da troca
- Cópia dos arquivos e do banco, e teste numa cópia do site.
- Plugins, tema e guia de migração conferidos.
- PHP-FPM novo instalado ao lado do antigo, com as extensões.
- Caminho do socket novo em
fastcgi_passouSetHandler. - Teste da configuração, recarga e conferência no Saúde do site.
Se o site quebrar depois da troca
Como o PHP antigo continua instalado, a volta é trocar de novo só o caminho do socket. Um exemplo, com a cópia feita no passo 4:
cp seusite.conf.bak seusite.conf
nginx -t
nginx -s reload
No Apache, use apachectl configtest e apachectl -k graceful no lugar dos dois últimos comandos. Com o site de pé na versão antiga, procure a causa nos logs. Pelo manual do PHP, a diretiva error_log da configuração global do FPM define o arquivo de log de erros; o servidor web tem o seu próprio log.
Depois da troca: o que revisar
Ajustes que estavam no php.ini da versão antiga, como limites de memória e de upload, ficam no arquivo daquela versão e não passam sozinhos para a nova. Recomendamos conferir com php --ini e comparar os valores.
A versão antiga e as extensões dela podem ser removidas depois, com cautela. Recomendamos esperar alguns dias com o site estável e confirmar que nenhum outro site do servidor usa aquele socket antes de remover.
Calendário das próximas versões
Pela tabela do php.net, o suporte ativo do 8.4 termina em 31/12/2026, e o de segurança do 8.3 em 31/12/2027, datas que valem uma anotação na agenda do servidor. Recomendamos rever a página de versões suportadas do php.net antes de cada revisão do servidor.
Um domínio novo, em centenas de extensões, pode ser registrado na Eleven Host. Buscar domínio
Perguntas frequentes
Qual versão do PHP usar em 19/11/2026?
Pelo php.net, 8.4 e 8.5 estão em suporte ativo, e 8.2 e 8.3 só com correções de segurança. Para WordPress, a página de requisitos recomenda 8.3 ou mais novo, e o manual de hospedagem recomenda 8.4 ou mais novo em produção.
Atualizar a versão do PHP pode quebrar o site?
Pode. O guia de migração do PHP 8.4 avisa que a versão traz incompatibilidades a testar antes de trocar em produção. Daí a cópia, o teste e a versão antiga instalada para voltar.
Por que o php -v mostra uma versão e o WordPress outra?
O comando mostra o PHP da linha de comando, e o site pode usar outro pelo PHP-FPM. Os dados do PHP que atende o site aparecem no Saúde do site, na seção Servidor da aba Info.