AWS Transform kan legacy-PHP-code analyseren, naar een nieuwere PHP-tak omzetten en valideren. Voor PHP2Shell moet je daarna ook de PHP-runtime in de draaiende omgeving patchen en de PHP-processen herstarten. De code-upgrade alleen verhelpt de kwetsbaarheden op een server die nog een getroffen runtime gebruikt. AWS beschrijft deze scheiding in zijn werkwijze voor PHP2Shell.
Beschouw een geslaagde codevalidatie als voorbereiding op de uitrol, niet als vervanging van de patch op de server.
PHP2Shell en de PHP-versies met een patch
PHP2Shell is de naam die AWS gebruikt voor CVE-2026-109618 en CVE-2026-109619. Volgens AWS kunnen beide kwetsbaarheden een niet-geauthenticeerde aanvaller code laten uitvoeren op een server die PHP-verzoeken verwerkt. De eerste gecorrigeerde versie verschilt per PHP-tak:
| PHP-tak | Getroffen versies | Eerste versie met patch |
| 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 |
| PHP 5.4–8.1 | AWS noemt deze takken als getroffen | Voor deze takken is volgens AWS geen PHP-release met een correctie beschikbaar |
AWS richt de beschreven upgrade op PHP 8.4 of 8.5. Voor oudere takken adviseert AWS te controleren of een distributie of leverancier van langetermijnondersteuning een backport levert; een backport is een correctie die naar een oudere softwaretak is overgezet.
De drie stappen: analyseren, transformeren en de runtime patchen
De werkwijze bestaat uit repositoryanalyse, een code-upgrade met validatie en vervolgens een aparte wijziging aan de runtime die de applicatie daadwerkelijk uitvoert. Alleen die laatste stap, gevolgd door een herstart, verhelpt PHP2Shell op het draaiende systeem.
Vereisten en een veilige werkomgeving
AWS noemt AWS Transform CLI 3.20.0 of nieuwer, Node.js 22 of nieuwer, Git, jq, passende AWS-toegang en Docker of een gepatchte PHP-versie van de gekozen doeltak op de machine waarop je transformeert. De precieze AWS-toegang hangt af van de omgeving waarin je werkt.
Gebruik een tijdelijke kopie van de repository en een wegwerpmachine zonder productiegegevens of productie-inloggegevens. De transformatie-agent kan vertrouwde tools uitvoeren. Zo beperk je de gevolgen als een opdracht of wijziging niet uitpakt zoals verwacht.
Repositories analyseren en de branch voorbereiden
- Voer eerst de snelle analyse uit. Die leest
composer.jsonen zoekt naar gebruik van een verouderde PHP-versie. In AWS’ voorbeeld duurt deze stap ongeveer 1–2 minuten per repository; dat is geen tijdsverwachting voor iedere codebase. - Voer ook de uitgebreide analyse uit. Die leest de broncode en kan volgens AWS stille gedragsveranderingen signaleren: wijzigingen die niet noodzakelijk een foutmelding geven, maar wel de uitkomst van code kunnen veranderen.
- Ga terug naar je werkbranch en maak de werkboom schoon. Verwijder de gegenereerde map
ATXDocumentationen controleer dat er geen ongewenste wijzigingen overblijven voordat je de remediation start.
AWS gebruikte voor zijn voorbeeld een PHP 7.4-applicatie met vijf kleine klassen en zeven PHPUnit-tests. De snelle scan vond daarin één bevinding met hoge ernst; de uitgebreide scan leverde per uitvoering 6–11 bevindingen op. Die aantallen horen bij dat voorbeeld, niet bij iedere applicatie.
De code transformeren en wijzigingen controleren
- Kies de bevindingen voor
AWS/php-version-upgradeen start de remediation voor de gewenste doeltak. De beheerde transformatie is gericht op het bijwerken van PHP-code naar een nieuwere PHP-tak, niet op een volledige herbouw van de applicatie. - Controleer de opgegeven transformatie en doeltak. AWS waarschuwt dat
--transformation-nameen-gbij elkaar horen: ontbreekt een van beide, dan kan de standaarddoeltak PHP 8.5 worden gekozen in plaats van de tak die je wilde gebruiken. - Lees de volledige wijzigingsset voordat je iets samenvoegt. Let extra op gedragswijzigingen, bijvoorbeeld bij losse vergelijkingen of invoercontroles. AWS meldt bovendien dat een remediation die vanuit bevindingen wordt gestart geen kostenlimiet heeft.
De branch vóór de uitrol valideren
AWS laat de transformatie de projecttests en een lintcontrole uitvoeren op een gepatchte PHP-runtime. Tests en linting controleren de codepaden die ze daadwerkelijk uitvoeren; ze tonen niet aan dat elk gedrag in de applicatie onveranderd blijft. Bekijk daarom naast de resultaten ook de volledige diff en de samenvatting van gedragswijzigingen.
Bij de geteste transformatieversie 2026-11-02 gebruikte AWS voor PHP 8.5 de Composer-beperking ^8.5.12 en voor PHP 8.4 ~8.4.27 || ^8.5.12. In AWS’ test kon de PHP 8.4-doelbranch onder PHP 8.5.11 starten, hoewel die runtime getroffen was. Een Composer-beperking is dus geen vervanging voor het patchen van de runtime die de applicatie werkelijk draait.
De runtime patchen en processen herstarten
- Werk de PHP-runtime bij in de omgeving waar je applicatie draait. Welke handeling nodig is, verschilt per deployment:
| Omgeving | Benodigde actie |
| Amazon Linux 2023 | Werk alle geïnstalleerde PHP-pakketten bij. |
| Containers | Bouw de containerimages opnieuw met een gepatchte basisimage en deploy ze opnieuw. |
| AWS Elastic Beanstalk | Voer een beheerde of handmatige platformupdate uit. |
| AWS Lightsail | Vervang de instances met een bijgewerkte blueprint. |
| Debian, Ubuntu, RHEL en builds met langetermijnondersteuning | Volg het beveiligingsadvies van de betreffende leverancier. |
| AWS Lambda met een eigen runtime of containerimage | Bouw de runtime of image opnieuw en deploy die opnieuw. |
- Herstart de PHP-processen na de runtime-update. Denk aan PHP-FPM, de webserver die PHP laadt en PHP-workers. Controleer dat deze processen de bijgewerkte runtime gebruiken; een getransformeerde codebranch verandert niet vanzelf de runtime van een al draaiende deployment.
Een PHP-upgrade is geen architectuurherschrijving
De beheerde AWS/php-version-upgrade-transformatie richt zich op een PHP-versie-upgrade. Een herschrijving naar een andere backend en frontend is een veel grotere, andere taak. In een afzonderlijk account over een eigen PHP-naar-Python/Angular-herschrijving beschreef François Dexemple dat bij een validatiemoment 3 van 88 templates waren omgezet; de frontend compileerde maar toonde een leeg scherm, en routes waren onvolledig of nagebootst. Dat is één projectervaring, geen voorspelling voor AWS’ beheerde PHP-upgrade.