Mantenha-se em um branch suportado (ex. 8.x). Teste apps em staging antes de atualizar. Verifique extensões e recursos obsoletos. Muitos hosts oferecem várias versões de PHP por site; use para migração gradual.
Branches suportados
- Suporte ativo: PHP 8.x recebem correções de segurança e bugs. Fique na última minor dentro da major que usa. Evite branches EOL (ex. 7.4 EOL; confira php.net/supported-versions).
- Caminho de upgrade: Planeje migrar para uma major suportada antes do EOL. Teste em dev e staging; corrija deprecações e código incompatível; depois atualize produção.
- Suporte do host: Muitos hosts oferecem várias versões de PHP por site. Use para rodar um site em 8.2 enquanto migra outro de 7.4.
Teste antes do upgrade
- Staging: Coloque a mesma app (ou cópia de prod) na versão de PHP alvo em staging. Rode suíte de testes e smoke tests manuais. Atenção a código custom e pacotes de terceiros.
- Extensões: Garanta que todas as extensões necessárias estejam disponíveis e em versão compatível.
php -mecomposer showajudam. - Recursos obsoletos: PHP 8 introduziu strict types, named args e muitas deprecações. Corrija avisos de depreciação nos logs; podem virar erros na próxima major. Use análise estática (ex. PHPStan).
Migração gradual
- Por site ou por app: Se tiver muitos sites ou apps, migre um de cada vez. Use o recurso de multi-versão do host para trocar um site para 8.x enquanto outros ficam em 7.x.
- Dependências: Atualize dependências do Composer para versões que suportem o PHP alvo. Alguns pacotes legados podem não ter suporte a PHP 8—planeje substituição ou fork.
- Documentação: Documente a versão de PHP por ambiente e o runbook de upgrade.
Resumo
Mantenha-se em um branch suportado (ex. 8.x). Teste apps em staging antes de atualizar. Verifique extensões e recursos obsoletos. Muitos hosts oferecem várias versões de PHP por site; use para migração gradual.
