AWS Transform może pomóc przygotować starszy kod PHP do przejścia na poprawioną wersję, ale nie aktualizuje za Ciebie środowiska działającego na serwerze. W opisanym przez AWS procesie trzeba osobno zaktualizować wdrożony runtime i zrestartować procesy PHP, by usunąć podatności PHP2Shell. AWS opisuje ten podział i kolejność działań.
PHP2Shell to określenie, którego AWS używa dla CVE-2026-109618 i CVE-2026-109619. Według AWS każda z tych podatności może pozwolić nieuwierzytelnionemu użytkownikowi na wykonanie kodu na serwerze obsługującym żądania PHP.
Które wersje PHP wymagają poprawki?
AWS wskazuje następujące pierwsze wersje zawierające poprawki dla poszczególnych gałęzi:
| Gałąź PHP | Wersje podatne | Pierwsza wersja z poprawką |
| 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 podaje, że gałęzie PHP od 5.4 do 8.1 nie mają wydania PHP usuwającego te podatności. Jeśli aplikacja korzysta z jednej z nich, sprawdź u dostawcy systemu lub długoterminowego wsparcia, czy dostępna jest poprawka przeniesiona na tę gałąź.
Co AWS Transform robi, a czego nie robi
AWS dzieli pracę na trzy etapy: analizę repozytorium, transformację i sprawdzenie kodu, a następnie aktualizację oraz restart wdrożonego środowiska. Dwa pierwsze przygotowują aplikację do pracy na nowszej wersji PHP; dopiero ostatni dotyczy działającego runtime’u.
Kod gotowy do wdrożenia i załatany serwer to dwa różne wyniki. Po transformacji sprawdź aplikację, a następnie osobno zaktualizuj runtime i zrestartuj procesy PHP.
Przygotuj bezpieczne środowisko
Według AWS opisana procedura wymaga AWS Transform CLI w wersji 3.20.0 lub nowszej, Node.js 22 lub nowszego, Git, jq, odpowiedniego dostępu do AWS oraz środowiska, na którym można uruchomić transformację. Przygotuj też Dockera albo poprawioną wersję PHP, do której przenosisz aplikację.
Pracuj na kopii repozytorium przeznaczonej do testów i użyj oddzielnej, jednorazowej maszyny bez poświadczeń produkcyjnych. Transformacja uruchamia agenta korzystającego z zaufanych narzędzi, więc izolacja ogranicza ryzyko związane z jego działaniem.
Analizuj repozytorium i przygotuj gałąź
Zacznij od dwóch analiz. Szybka analiza odczytuje composer.json i wskazuje przestarzałą wersję PHP. Analiza kompleksowa czyta kod źródłowy; AWS wskazuje ją jako etap, który może ujawnić ciche zmiany zachowania, niewidoczne jako błędy wykonania.
W przykładzie AWS aplikacja PHP 7.4 zawierała pięć małych klas i siedem testów PHPUnit. Szybka analiza zwróciła jedno ustalenie o wysokiej wadze, a analiza kompleksowa od sześciu do jedenastu ustaleń zależnie od uruchomienia. To wyniki tego przykładu, nie prognoza dla innego repozytorium.
Po analizie wróć do gałęzi roboczej, usuń wygenerowany katalog ATXDocumentation i upewnij się, że drzewo robocze jest czyste. Dopiero wtedy przejdź do tworzenia transformacji.
Uruchom transformację i przejrzyj zmiany
Wybierz ustalenia przypisane do zarządzanej transformacji AWS/php-version-upgrade i wskaż docelową gałąź PHP. Jeśli podajesz cel za pomocą --transformation-name, użyj również -g: AWS ostrzega, że pominięcie któregoś z tych parametrów może spowodować wybór domyślnego celu PHP 8.5 zamiast wskazanej wersji.
Po zakończeniu sprawdź pełny zestaw zmian, podsumowanie zmian zachowania i wynik walidacji. Zwróć szczególną uwagę na porównania luźne i warunki sprawdzające dane wejściowe. W przykładzie AWS zmiana zachowania wyrażenia 0 == "abc" mogła nie wywołać błędu, a mimo to zmienić wynik działania aplikacji.
Walidacja nie zastępuje poprawki runtime’u
Transformacja uruchamia testy projektu i sprawdzanie składni, czyli lintowanie. Wynik mówi o ścieżkach objętych tymi kontrolami; nie gwarantuje identycznego działania każdej części aplikacji. Przejrzyj zmiany i sprawdź, czy testy pokrywają istotne dla Twojego systemu scenariusze.
Zwróć też uwagę na wersję PHP, na której sprawdzono wynik. Dla celu PHP 8.5 AWS podaje ograniczenie Composera ^8.5.12, a dla celu PHP 8.4: ~8.4.27 || ^8.5.12. W swoich testach AWS stwierdził, że aplikacja przygotowana dla PHP 8.4 mogła mimo to uruchomić się na podatnym PHP 8.5.11. Ograniczenie w Composerze nie zastępuje więc aktualizacji środowiska na serwerze.
Zmiana wersji PHP to również inna praca niż przebudowa aplikacji na inny stos technologiczny. W osobnym, indywidualnym opisie François Dexemple relacjonował niestandardową migrację PHP do Python i Angular: w jednym punkcie kontroli przekonwertowane były 3 z 88 szablonów, frontend się kompilował, ale wyświetlał pusty ekran, a część tras backendu była nieukończona lub zamockowana. To relacja z przebudowy architektury, nie wynik zarządzanej transformacji zmieniającej wersję PHP.
Zaktualizuj wdrożone środowisko i zrestartuj procesy
Po przygotowaniu kodu zaktualizuj PHP tam, gdzie rzeczywiście działa aplikacja. Konkretna operacja zależy od sposobu wdrożenia:
| Środowisko | Działanie |
| Amazon Linux 2023 | Zaktualizuj zainstalowane pakiety PHP. |
| Kontenery | Zbuduj ponownie i wdroż obrazy z poprawionym środowiskiem bazowym. |
| AWS Elastic Beanstalk | Wykonaj aktualizację platformy zarządzaną przez usługę albo aktualizację ręczną. |
| AWS Lightsail | Zastąp instancje, korzystając ze zaktualizowanego blueprintu. |
| Debian, Ubuntu, RHEL i wersje z długoterminowym wsparciem | Postępuj zgodnie z zaleceniami dostawcy danej dystrybucji. |
| AWS Lambda z własnym runtime’em lub obrazem kontenera | Przebuduj i ponownie wdroż runtime albo obraz. |
Po aktualizacji zrestartuj PHP-FPM, serwer WWW ładujący PHP oraz pozostałe procesy PHP. Dopiero poprawiona wersja uruchomiona w docelowym środowisku, wraz z restartem tych procesów, zamyka etap naprawy PHP2Shell opisany przez AWS.