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 PHP | Versões afetadas | Primeira versão corrigida |
| PHP 8.5 | 8.5.0–8.5.11 | 8.5.12 |
| PHP 8.4 | 8.4.0–8.4.26 | 8.4.27 |
| PHP 8.3 | 8.3.0–8.3.35 | 8.3.36 |
| PHP 8.2 | 8.2.0–8.2.34 | 8.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
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
- 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.
- Analise o repositório. A análise rápida lê o
composer.jsonpara 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. - Transforme os problemas selecionados. A AWS descreve o uso da transformação gerenciada
AWS/php-version-upgradepara 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. - 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.
- 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. - 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.