O AWS Transform pode analisar e atualizar o código PHP legado para uma versão corrigida, mas não corrige sozinho o servidor em produção. Para remediar PHP2Shell, é preciso atualizar separadamente o runtime implantado e reiniciar os processos PHP, como descreve a AWS.

PHP2Shell e as versões corrigidas

A AWS chama de PHP2Shell as vulnerabilidades CVE-2026-109618 e CVE-2026-109619. Segundo a empresa, elas podem permitir que alguém sem autenticação execute código em um servidor que processe requisições PHP. A AWS lista estas primeiras versões corrigidas por ramo:

Ramo do PHPVersões afetadasPrimeira versão corrigida
PHP 8.58.5.0–8.5.118.5.12
PHP 8.48.4.0–8.4.268.4.27
PHP 8.38.3.0–8.3.358.3.36
PHP 8.28.2.0–8.2.348.2.35

A AWS recomenda levar o código legado para PHP 8.4 ou 8.5, avaliando a compatibilidade da aplicação. Segundo a empresa, as versões do PHP de 5.4 a 8.1 não têm um lançamento do próprio PHP que corrija essas falhas. Para esses ramos, verifique se o fornecedor da distribuição ou de uma versão de suporte prolongado oferece correções retroportadas.

A NeoTeo também publicou, em espanhol, um resumo das versões do PHP que corrigem as falhas.

O fluxo separa a mudança no código da correção do servidor

Diagrama conceitual separa a análise e transformação do código da correção e reinicialização do runtime implantado.

O processo tem três etapas: analisar os repositórios, transformar e validar o código e, por fim, atualizar e reiniciar o runtime implantado. As duas primeiras preparam a aplicação para uma versão corrigida; a última é a que remedia as vulnerabilidades no servidor em execução.

Trate a transformação como preparação do código. A correção só se completa no ambiente implantado, com o runtime atualizado e os processos PHP reiniciados.

Pré-requisitos e ambiente seguro

Antes de começar, prepare:

  • AWS Transform CLI versão 3.20.0 ou posterior;
  • Node.js 22 ou posterior, Git e jq;
  • acesso e permissões adequados na AWS;
  • Docker ou uma versão corrigida do PHP de destino na máquina que executará a transformação.

Use clones descartáveis dos repositórios e uma máquina temporária, sem credenciais de produção. A transformação executa um agente de IA com ferramentas autorizadas; manter o trabalho isolado reduz o risco de expor sistemas ou acessos de produção.

Como executar a migração

  1. Escolha a versão de destino e prepare o ambiente isolado. Defina o ramo do PHP para o qual a aplicação será atualizada e use um clone descartável. A versão de destino determina quais mudanças de compatibilidade precisarão ser revistas.
  2. Analise o repositório. A análise rápida lê o composer.json para identificar dependências de uma versão do PHP fora de suporte. A análise abrangente examina o código e pode encontrar mudanças de comportamento que não geram erro evidente. Para avaliar esses riscos, não pule a análise abrangente.Na aplicação de exemplo da AWS, escrita para PHP 7.4 e composta por cinco classes e sete testes PHPUnit, a análise rápida encontrou um problema de alta gravidade. A abrangente apontou de seis a onze problemas, dependendo da execução. Esses resultados descrevem aquele exemplo, não o que você deve esperar no seu projeto.
  3. Transforme os problemas selecionados. A AWS descreve o uso da transformação gerenciada AWS/php-version-upgrade para atualizar o código e tratar os problemas identificados. O objetivo é preparar a aplicação para o ramo escolhido, não atualizar o servidor que já está executando PHP.
  4. Revise as alterações e valide a aplicação. Examine o diff completo, com atenção a mudanças de comportamento que possam passar sem erros de sintaxe. A validação descrita pela AWS executa os testes do projeto e uma verificação de sintaxe; ela cobre apenas os caminhos exercitados por esses testes. Amplie a cobertura e revise os fluxos importantes da aplicação antes de integrar as mudanças.No exemplo da AWS, a análise abrangente identificou alterações silenciosas, inclusive em comparações e construções removidas ou mais restritas entre versões. Por isso, uma execução bem-sucedida dos testes e da verificação de sintaxe não substitui a leitura das mudanças.
  5. Atualize o runtime no ambiente implantado. Aplique a versão corrigida no local em que o PHP realmente roda. A ação depende da infraestrutura:AmbienteAção para atualizar o runtimeAmazon Linux 2023Atualize todos os pacotes PHP instalados.ContêineresReconstrua e implante novamente as imagens com a versão corrigida.AWS Elastic BeanstalkUse uma atualização de plataforma gerenciada ou manual.Amazon LightsailSubstitua as instâncias usando um blueprint atualizado.Debian, Ubuntu, RHEL e versões de suporte prolongadoSiga as orientações do fornecedor da distribuição ou do suporte contratado.AWS Lambda com runtime personalizado ou imagem de contêinerReconstrua e implante novamente o runtime ou a imagem.Em um projeto com destino PHP 8.5, a configuração do Composer descrita pela AWS foi ^8.5.12; para PHP 8.4, foi ~8.4.27 || ^8.5.12. Ainda assim, nos testes relatados pela AWS, a verificação de plataforma gerada para o destino 8.4 permitiu iniciar a aplicação em PHP 8.5.11, uma versão vulnerável. Portanto, a restrição do Composer não substitui a atualização do runtime implantado.
  6. Reinicie os processos PHP. Depois de atualizar o runtime, reinicie o PHP-FPM, os servidores web que carregam PHP e os workers PHP. Sem essa etapa, os processos em execução podem continuar usando o runtime anterior.