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 PHPVersions concernéesPremière version corrigée
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

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

Schéma abstrait montrant un dépôt analysé et transformé, puis une étape distincte de mise à jour du runtime déployé et de redémarrage des processus PHP.

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 :

EnvironnementAction pour mettre à jour le runtime
Amazon Linux 2023Mettre à jour tous les paquets PHP installés.
ConteneursReconstruire et redéployer les images à partir d’une image de base corrigée.
AWS Elastic BeanstalkAppliquer une mise à jour de la plateforme, gérée ou manuelle.
Amazon LightsailRemplacer 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 conteneurReconstruire 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.