Per migrare un’applicazione PHP legacy con AWS Transform, analizza il repository, trasforma il codice e convalidalo; poi aggiorna e riavvia separatamente il runtime distribuito. È quest’ultimo intervento a correggere PHP2Shell sul sistema in esecuzione.
AWS chiama PHP2Shell le vulnerabilità CVE-2026-109618 e CVE-2026-109619. Secondo la guida di AWS, ciascuna ha un punteggio CVSS v4.0 di 9,2 e può consentire a un utente non autenticato di eseguire codice su un server che gestisce richieste PHP. Per il contesto sulle versioni corrette, leggi anche l’articolo di NeoTeo sulle correzioni PHP per queste vulnerabilità.
Considera la trasformazione del codice e la patch del runtime come due attività distinte: completare la prima non aggiorna il PHP che serve già l’applicazione.
PHP2Shell: le versioni PHP corrette
Nella guida pubblicata il 16 novembre 2026, AWS indica queste prime versioni corrette per i rami PHP interessati:
| Ramo PHP | Versioni interessate | Prima versione corretta |
| 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 riferisce inoltre che per i rami da PHP 5.4 a 8.1 non esiste una release PHP che corregga queste vulnerabilità. Se l’applicazione usa uno di questi rami, controlla se il fornitore della distribuzione o un servizio di supporto a lungo termine distribuisce correzioni retroportate; AWS indica questa verifica come alternativa per le installazioni che non possono passare subito a un ramo più recente.
Le fasi: analisi, trasformazione e patch del runtime
AWS separa il lavoro in tre passaggi: analizzare i repository, trasformare e convalidare il codice, quindi aggiornare e riavviare il runtime distribuito. AWS Transform continuous modernization gestisce l’analisi e la preparazione del codice; l’aggiornamento del server o dell’ambiente che esegue PHP resta un intervento distinto.
Preparare un ambiente di lavoro isolato
Per la procedura descritta da AWS servono AWS Transform CLI 3.20.0 o successiva, Node.js 22 o successivo, Git, jq, un account AWS con accessi adeguati e Docker oppure una versione corretta di PHP corrispondente al ramo di destinazione. La trasformazione gestisce strumenti con autorizzazioni: AWS raccomanda quindi copie temporanee dei repository e una macchina usa e getta, senza credenziali di produzione.
Scegli prima il ramo PHP di destinazione. AWS indica PHP 8.4 o 8.5 per il passaggio del codice legacy a una versione recente; per queste vulnerabilità, la tabella sopra riporta anche le prime versioni corrette dei rami 8.2 e 8.3.
Analizzare i repository e preparare il branch
- Esegui l’analisi rapida. AWS spiega che questa scansione legge
composer.jsonper individuare le dipendenze da versioni PHP fuori supporto. - Esegui l’analisi completa. Questa esamina il codice e può individuare cambiamenti di comportamento silenziosi, cioè differenze che non generano necessariamente un errore evidente. Nel campione PHP 7.4 di AWS, composto da cinque classi e sette test PHPUnit, la scansione rapida ha restituito un rilievo ad alta gravità; quella completa ne ha restituiti da 6 a 11, a seconda dell’esecuzione. Sono risultati di quel campione, non una previsione per altri repository.
- Torna al branch di lavoro e puliscilo. Rimuovi la cartella generata
ATXDocumentatione verifica che l’albero di lavoro sia pulito prima di avviare la remediation. In questo modo puoi distinguere i cambiamenti introdotti dalla trasformazione da quelli già presenti.
Trasformare il codice e rivedere le modifiche
- Crea la remediation per i rilievi pertinenti. Seleziona quelli assegnati alla trasformazione gestita
AWS/php-version-upgradee scegli il ramo di destinazione. AWS specifica che--transformation-namee-gvanno usati insieme: omettere uno dei due può far ricadere la trasformazione sul ramo PHP 8.5 predefinito anziché su quello scelto. - Esamina l’intero diff e il riepilogo dei cambiamenti di comportamento. Un aggiornamento di versione può richiedere modifiche oltre a quelle segnalate come errori espliciti. Nel campione AWS, per esempio, la comparazione permissiva
0 == "abc"aveva un comportamento diverso. Verifica i percorsi interessati con i test del progetto e controlla i cambiamenti non coperti dai test.
La remediation avviata dai rilievi non ha un limite di spesa automatico, secondo AWS. Se un’esecuzione si interrompe, non unire il branch prodotto senza aver prima esaminato lo stato della trasformazione e i cambiamenti generati.
Convalidare il branch prima del rilascio
- Controlla la convalida sul runtime corretto. AWS descrive una verifica con i test del progetto e un controllo sintattico (lint) su un runtime PHP aggiornato. Controlla che l’esecuzione completata indichi la convalida sulla release corretta per il ramo scelto. Test e lint coprono i percorsi che esercitano: non garantiscono che ogni comportamento dell’applicazione sia identico.
Per la trasformazione versione 2026-11-02, AWS riporta questi vincoli Composer generati:
- Destinazione PHP 8.5:
^8.5.12 - Destinazione PHP 8.4:
~8.4.27 || ^8.5.12
Nel test AWS, l’output destinato a PHP 8.4 è riuscito ad avviarsi anche su PHP 8.5.11, una versione vulnerabile. Il controllo della piattaforma di Composer, quindi, non sostituisce l’aggiornamento del runtime distribuito.
Applicare la patch al runtime e riavviare i processi
- Aggiorna l’ambiente in cui gira PHP. L’intervento dipende da come viene distribuita l’applicazione:
| Ambiente | Intervento sul runtime |
| Amazon Linux 2023 | Aggiorna tutti i pacchetti PHP installati. |
| Container | Ricostruisci e ridistribuisci l’immagine con una base corretta. |
| AWS Elastic Beanstalk | Applica un aggiornamento della piattaforma gestito o manuale. |
| Amazon Lightsail | Sostituisci le istanze usando un blueprint aggiornato. |
| Debian, Ubuntu, RHEL e build con supporto a lungo termine | Segui l’avviso di sicurezza del fornitore della distribuzione o del servizio di supporto. |
| AWS Lambda con runtime personalizzato o immagine container | Ricostruisci e ridistribuisci il runtime o l’immagine. |
Dopo l’aggiornamento, riavvia PHP-FPM, il server web che carica PHP e gli altri processi PHP interessati. Il riavvio fa sì che i processi in esecuzione utilizzino il runtime aggiornato, invece di continuare con quello già avviato.
Aggiornare PHP non significa riscrivere l’architettura
La trasformazione AWS/php-version-upgrade riguarda il passaggio a un altro ramo PHP; una riscrittura in un linguaggio e in un’architettura diversi è un progetto più ampio. François Dexemple, raccontando separatamente una migrazione personalizzata da PHP a Python e Angular, riferisce che in un punto della convalida erano state convertite 3 pagine modello su 88: il frontend compilava ma mostrava una schermata vuota, e alcune rotte Python erano incomplete o simulate. È il resoconto di quel singolo progetto, non un risultato della trasformazione gestita per l’aggiornamento di versione.