AWS Transform peut analyser un dépôt PHP ancien, transformer son code pour une branche plus récente et le valider. Mais la correction de PHP2Shell exige aussi une mise à jour du runtime qui exécute l’application, puis le redémarrage des processus PHP. AWS décrit ces étapes séparées dans son guide.
Pour corriger le serveur, ne vous arrêtez pas au dépôt : le runtime déployé doit recevoir son propre correctif et être redémarré.
PHP2Shell : quelles versions corriger ?
AWS regroupe sous le nom PHP2Shell les vulnérabilités CVE-2026-109618 et CVE-2026-109619. Selon AWS, chacune peut permettre à une personne non authentifiée d’exécuter du code sur un serveur qui traite des requêtes PHP. Les versions corrigées ci-dessous sont les premières indiquées par branche dans son guide.
| Branche PHP | Versions concernées | Première version corrigée |
| 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 indique qu’aucune version de PHP ne corrige ces vulnérabilités dans les branches 5.4 à 8.1. Pour une distribution ou un fournisseur proposant des correctifs rétroportés, vérifiez son avis de sécurité et la version effectivement installée. AWS recommande PHP 8.4 ou 8.5 comme branches cibles pour moderniser le code.
Les trois opérations à enchaîner
Le parcours comporte trois étapes distinctes : analyser le dépôt, transformer et valider le code, puis corriger et redémarrer le runtime déployé. La transformation prépare le code à fonctionner sur une branche corrigée ; elle ne met pas à jour le PHP du serveur en production.
Préparer un environnement de travail isolé
Le guide AWS demande AWS Transform CLI 3.20.0 ou une version ultérieure, Node.js 22 ou une version ultérieure, Git, jq et un accès AWS adapté. La machine qui exécute la transformation doit disposer de Docker ou d’une version corrigée de PHP correspondant à la branche cible. Les prérequis de démarrage d’AWS Transform sont détaillés dans la documentation AWS.
Travaillez sur des clones temporaires des dépôts et sur une machine jetable, sans identifiants de production. L’agent exécute des commandes avec des outils auxquels il fait confiance : gardez son environnement de travail séparé des systèmes de production.
1. Analyser le dépôt
L’analyse rapide lit composer.json pour repérer les dépendances à une version de PHP en fin de vie. L’analyse complète examine le code et peut révéler des changements de comportement silencieux, c’est-à-dire des différences qui ne déclenchent pas nécessairement d’erreur.
Les résultats chiffrés d’AWS concernent son exemple, un petit projet PHP 7.4 composé de cinq classes et de sept tests PHPUnit : l’analyse rapide y a relevé un problème de gravité élevée, tandis que l’analyse complète en a signalé entre 6 et 11 selon les exécutions. Ce sont les résultats de cet exemple, pas une estimation pour votre dépôt.
2. Lancer la transformation de mise à niveau
Examinez les constats, puis choisissez ceux auxquels appliquer la transformation gérée AWS/php-version-upgrade. Le guide AWS présente PHP 8.4 et PHP 8.5 comme branches cibles. Cette mise à niveau de version reste une opération PHP : elle ne constitue pas une réécriture de l’application dans un autre langage ou une autre architecture.
La distinction compte si vous envisagez un remplacement complet. Dans un récit personnel distinct, François Dexemple rapporte que, lors d’un point de validation d’une migration personnalisée de PHP vers Python et Angular, seuls 3 des 88 modèles étaient convertis ; l’interface compilait mais affichait un écran blanc, et certaines routes Python étaient incomplètes ou simulées. Ce chantier architectural avait une portée différente de la mise à niveau gérée d’une branche PHP.
3. Examiner les changements et valider la branche
Relisez l’intégralité des différences produites, en portant une attention particulière aux changements de comportement. Dans son exemple, AWS signale notamment une modification d’une comparaison faible comme 0 == "abc". Un tel changement peut passer inaperçu s’il n’entraîne pas d’erreur immédiate.
AWS indique que la validation exécute les tests du projet et une analyse de syntaxe (lint) sur un runtime PHP corrigé. Ces contrôles couvrent les chemins exercés par les tests et le lint ; ils ne garantissent pas que chaque comportement de l’application restera identique. Examinez donc aussi le résumé des changements de comportement avant de retenir la branche transformée.
Vérifiez enfin la contrainte PHP générée par Composer. Pour la transformation version 2026-11-02, AWS indique ^8.5.12 pour une cible PHP 8.5 et ~8.4.27 || ^8.5.12 pour une cible 8.4. Dans ses tests, l’application préparée pour PHP 8.4 pouvait tout de même démarrer sous PHP 8.5.11 : le contrôle de plateforme généré par Composer vérifiait la version minimale autorisée. La contrainte ne remplace donc pas la vérification et la mise à jour du runtime réellement utilisé.
4. Mettre à jour le runtime selon le déploiement
Appliquez le correctif à l’environnement où PHP s’exécute. AWS décrit les actions suivantes :
| Environnement | Action pour mettre à jour le runtime |
| Amazon Linux 2023 | Mettre à jour tous les paquets PHP installés. |
| Conteneurs | Reconstruire et redéployer les images à partir d’une image de base corrigée. |
| AWS Elastic Beanstalk | Appliquer une mise à jour de la plateforme, gérée ou manuelle. |
| Amazon Lightsail | Remplacer les instances à partir d’un plan actualisé. |
| Debian, Ubuntu, RHEL et versions à support prolongé | Suivre les avis du fournisseur de la distribution. |
| AWS Lambda avec runtime personnalisé ou image conteneur | Reconstruire et redéployer le runtime ou l’image. |
5. Redémarrer les processus PHP
Après la mise à jour, redémarrez PHP-FPM, les serveurs web qui chargent PHP et les workers PHP concernés. Vérifiez ensuite la version PHP en cours d’exécution : c’est le runtime actif, et non la seule branche de code transformée, qui doit être corrigé pour que l’application déployée bénéficie du correctif.