Para preparar una aplicación PHP heredada con AWS Transform, analiza el repositorio, transforma el código a una rama corregida y revisa las pruebas y los cambios. Después, actualiza por separado el runtime donde se ejecuta la aplicación y reinicia sus procesos: esa última operación es la que corrige PHP2Shell en el sistema desplegado, según la guía de AWS.
Trata la transformación del código y el parche del runtime como dos tareas distintas: completar la primera no sustituye a la segunda.
PHP2Shell y las versiones corregidas
AWS usa el nombre PHP2Shell para dos vulnerabilidades, CVE-2026-109618 y CVE-2026-109619. Según la compañía, cada una puede permitir que una persona no autenticada ejecute código en un servidor que atiende peticiones PHP. AWS señala que el proyecto PHP publicó las correcciones el 21 de octubre de 2026.
| Rama de PHP | Versiones afectadas | Primera versión corregida |
| 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 |
AWS indica que las ramas PHP 5.4–8.1 no tienen una versión de PHP que corrija estas vulnerabilidades. Si tu despliegue depende de una rama antigua, comprueba si el proveedor de la distribución o del soporte de largo plazo ofrece parches adaptados. Para ampliar el contexto de las versiones corregidas, puedes consultar la cobertura de NeoTeo sobre los parches de PHP.
El flujo: analizar, transformar y corregir el runtime
AWS separa el trabajo en tres etapas: analizar los repositorios, transformar y validar el código, y parchear y reiniciar el runtime desplegado. AWS Transform se ocupa de las dos primeras; la tercera depende del entorno donde se ejecuta PHP.
Requisitos y entorno de trabajo seguro
El procedimiento de AWS requiere AWS Transform CLI 3.20.0 o posterior, Node.js 22 o posterior, Git, jq y acceso adecuado a AWS. Para ejecutar la transformación, la máquina necesita Docker o una versión de PHP corregida de la rama objetivo. El flujo se plantea para destinos PHP 8.4 o 8.5.
Trabaja con clones desechables del repositorio y una máquina que puedas descartar. AWS recomienda no usar credenciales de producción: el agente ejecuta comandos mediante herramientas de confianza y los cambios deben revisarse antes de llegar a un entorno real.
1. Analiza los repositorios
AWS Transform ofrece dos análisis con alcances diferentes. El rápido lee composer.json para localizar dependencias de versiones de PHP sin soporte. El exhaustivo examina el código y puede señalar cambios de comportamiento silenciosos: modificaciones que no necesariamente producen un error visible, pero sí pueden alterar el resultado de una operación.
En la muestra de AWS, una aplicación PHP 7.4 con cinco clases y siete pruebas de PHPUnit generó un hallazgo de alta gravedad en el análisis rápido y entre seis y once hallazgos en el exhaustivo, según la ejecución. Son resultados de esa muestra, no una previsión para otros repositorios.
2. Transforma el código y revisa los cambios
Selecciona los hallazgos que correspondan a la transformación administrada AWS/php-version-upgrade y crea la remediación para la rama PHP que hayas elegido. La transformación prepara el código para esa versión; no actualiza con ello el servidor o la imagen donde se ejecuta la aplicación.
Revisa el diff completo y el resumen de cambios de comportamiento antes de integrar la rama. En la muestra de AWS aparecieron construcciones eliminadas o más estrictas, como $text{0}, create_function(), each() y count(null), además de un cambio en la comparación flexible 0 == "abc". Una modificación de ese tipo puede cambiar el resultado sin que la aplicación falle de forma evidente, por lo que conviene ejercitar con pruebas las rutas afectadas.
3. Valida la rama contra la versión corregida
La transformación ejecuta las pruebas del proyecto y un análisis de sintaxis (lint) en un runtime PHP corregido. Esas comprobaciones cubren los casos que ejercitan las pruebas y el análisis; revisa también el código modificado y los comportamientos que no cubra tu suite.
Composer tampoco garantiza por sí solo que el runtime desplegado esté parcheado. Para PHP 8.5, AWS documenta la restricción ^8.5.12; para PHP 8.4, ~8.4.27 || ^8.5.12. En sus pruebas, la comprobación de plataforma generada para el objetivo PHP 8.4 permitió que la aplicación arrancara con PHP 8.5.11, una versión afectada. Por eso la validación de la rama y la actualización del runtime siguen siendo tareas distintas.
4. Actualiza el runtime según el despliegue
Aplica el parche en el entorno donde realmente se ejecuta PHP. AWS describe estas acciones para los tipos de despliegue cubiertos por su guía:
| Entorno | Acción para corregir el runtime |
| Amazon Linux 2023 | Actualizar todos los paquetes PHP instalados. |
| Contenedores | Reconstruir y volver a desplegar las imágenes con una base corregida. |
| AWS Elastic Beanstalk | Aplicar una actualización de plataforma administrada o manual. |
| Amazon Lightsail | Sustituir las instancias a partir de una imagen de sistema actualizada. |
| Debian, Ubuntu, RHEL y versiones con soporte de largo plazo | Seguir los avisos de seguridad del proveedor correspondiente. |
| AWS Lambda con runtime personalizado o imagen de contenedor | Reconstruir y volver a desplegar el runtime o la imagen. |
Tras actualizarlo, reinicia PHP-FPM, los servidores web que cargan PHP y los procesos PHP de larga duración que atienden trabajos en segundo plano. Si solo cambias la rama del repositorio, esos procesos pueden seguir usando el runtime que ya estaba desplegado.
Una actualización de PHP no es una reescritura arquitectónica
Actualizar una aplicación a otra versión de PHP es una tarea más acotada que sustituir PHP por otra arquitectura. En una experiencia independiente con una reescritura personalizada de PHP a Python y Angular, François Dexemple contó que, en un punto de validación, se habían convertido 3 de 88 plantillas; el frontend compilaba, pero mostraba una pantalla en blanco, y algunas rutas de Python estaban incompletas o simuladas. Ese caso describe su proyecto de reescritura, no la transformación administrada para actualizar la versión de PHP.