Migracja PHP ze starej wersji na aktualną (8.4/8.5) to jedna z najbardziej opłacalnych modernizacji w starym systemie — usuwa całą klasę ryzyk bezpieczeństwa, przyspiesza aplikację bez zmian w kodzie biznesowym i odblokowuje aktualizacje frameworków oraz bibliotek. PHP 5.6 nie ma wsparcia bezpieczeństwa od końca 2018 roku, PHP 7.4 od listopada 2022, a PHP 8.1 od końca 2025 — systemy na tych wersjach działają dziś bez łat na znane podatności. Ten przewodnik pokazuje, jak zaplanować migrację krok po kroku, co się psuje, ile to trwa i ile kosztuje.
Najważniejsze: Migracja PHP to proces, nie podmiana wersji na serwerze. Kolejność: audyt zgodności (PHPCompatibility, PHPStan) → testy zabezpieczające → automatyczna refaktoryzacja (Rector) → staging → produkcja z monitoringiem. Bezpieczna migracja przez wersję pośrednią (np. 7.4) jest szybsza niż skok przez dwie generacje, choć w prostych projektach możliwy jest skok bezpośredni.
Dlaczego stara wersja PHP to problem
Trzy koszty, które rosną z każdym rokiem.
Bezpieczeństwo. Wersje PHP po zakończeniu wsparcia nie dostają poprawek bezpieczeństwa. To nie teoretyczne ryzyko — znane podatności w interpreterze i bibliotekach standardowych zostają publicznie udokumentowane, a działający system staje się celem. W systemach obsługujących płatności czy dane osobowe to ryzyko compliance, nie tylko techniczne.
Kompatybilność ekosystemu. Nowe wersje bibliotek i frameworków wymagają nowych wersji PHP. Zostając na 5.6 czy 7.x, tracisz dostęp do aktualizacji, a wraz z nimi do poprawek bezpieczeństwa i wydajności. Coraz częściej także hostingi wygaszają obsługę starych wersji — musisz płacić za „dodatki legacy" albo szukać specjalnych rozwiązań.
Wydajność i koszty utrzymania. PHP 8.x jest istotnie szybsze od PHP 5.6 — sam JIT i optymalizacje silnika potrafią przyspieszyć aplikację o dziesiątki procent bez zmian w kodzie. Do tego dochodzi koszt ludzi: programistów znających PHP 5.6 jest coraz mniej, a stawki rosną. Szeroki kontekst tych kosztów rozkładam w artykule o długu technologicznym.
Wersje PHP i daty wsparcia — co jest jeszcze bezpieczne
Cykl wydawniczy PHP to od 2024 roku cztery lata wsparcia: dwa lata poprawek błędów i dwa lata poprawek bezpieczeństwa. Po tym okresie gałąź osiąga end of life (EOL) i nie dostaje już żadnych aktualizacji — nawet krytycznych.
| Wersja | Premiera | Wsparcie bezpieczeństwa do | Status na dziś |
|---|---|---|---|
| PHP 8.5 | 20.11.2025 | 31.12.2029 | pełne wsparcie |
| PHP 8.4 | 21.11.2024 | 31.12.2028 | pełne wsparcie |
| PHP 8.3 | 23.11.2023 | 31.12.2027 | tylko poprawki bezpieczeństwa |
| PHP 8.2 | 08.12.2022 | 31.12.2026 | tylko poprawki bezpieczeństwa — kończy się |
| PHP 8.1 | 25.11.2021 | 31.12.2025 | koniec wsparcia |
| PHP 8.0 | 26.11.2020 | 26.11.2023 | koniec wsparcia |
| PHP 7.4 | 28.11.2019 | 28.11.2022 | koniec wsparcia |
| PHP 7.3 i starsze | 2018 i wcześniej | 2021 i wcześniej | koniec wsparcia |
Uwaga: PHP 8.2 kończy wsparcie bezpieczeństwa 31 grudnia 2026. Jeśli Twój system działa na 8.2, to ostatni moment, żeby zaplanować aktualizację — po tej dacie każda nowa podatność w interpreterze zostanie bez łaty. Szczegóły i plan działania opisuję w artykule o końcu wsparcia PHP 8.2.
Pełny harmonogram z datami premier i wsparcia wszystkich wersji — wraz z tym, która wersja jest bezpieczna dla jakiego typu projektu — zebrałem w osobnym artykule o wersjach PHP i datach wsparcia.
Co nowego w PHP 8 — co zyskujesz po migracji
Migracja to nie tylko „łatki bezpieczeństwa". PHP 8.x to także funkcje, które zmieniają sposób pisania kodu — i argumenty, które przekonują zespół.
- JIT (od 8.0) — kompilacja fragmentów kodu do kodu maszynowego w czasie działania. Największy zysk tam, gdzie liczy się CPU (obliczenia, przetwarzanie danych), mniejszy przy aplikacjach ograniczonych wejściem/wyjściem.
- Atrybuty (od 8.0) — natywne metadane klas i metod (
#[Route],#[Test]) zamiast adnotacji w komentarzach PHPDoc. Frameworki (Symfony, Laravel, Doctrine) przeniosły na nie konfigurację. - Named arguments (od 8.0) — wywołania
funkcja(limit: 10, offset: 0)— czytelniejsze i odporne na zmianę kolejności parametrów. - Constructor property promotion (od 8.0) —
public function __construct(private Logger $logger)zamiast ręcznego przypisywania pól. - Match expression (od 8.0) — następca
switchz porównaniem ścisłym i wartością zwracaną. - Enums (od 8.1) — typy wyliczeniowe
enum Status: string, których brakowało od lat. - Readonly properties (od 8.1) — niezmienne pola obiektów bez getterów.
- Fibers (od 8.1) — podstawa dla współbieżności w bibliotekach (Amphp, ReactPHP).
- Typy
true/false/nulli typy w stałych klas (od 8.2/8.3) — dokładniejszy system typów. - Property hooks i asymetryczna widoczność (od 8.4) — gettery/settery bezpośrednio na właściwościach.
Nie każda z tych funkcji jest powodem do migracji samym w sobie, ale razem zmieniają to, jak wygląda nowy kod w projekcie — a stare konstrukcje z czasem przestają być wspierane przez narzędzia (PHPStan, Rector, IDE).
Jak wygląda droga migracji
Najbezpieczniejsza ścieżka z PHP 5.6 prowadzi przez wersję pośrednią — 7.4 albo 8.0 — i dopiero potem na 8.3+. Skok przez dwie generacje naraz jest możliwy, ale zwykle oznacza więcej błędów naraz i trudniejszą diagnozę. Wersja pośrednia daje punkty kontrolne: po każdym kroku testy, wdrożenie, obserwacja.
| Start | Zalecana ścieżka | Typowy czas małego projektu |
|---|---|---|
| PHP 5.6 | 5.6 → 7.4 → 8.0 → 8.4 | 2–4 tygodnie |
| PHP 7.0–7.3 | 7.x → 7.4 → 8.4 | 1–3 tygodnie |
| PHP 7.4 | 7.4 → 8.0 → 8.4 (albo bezpośrednio 8.4) | 1–2 tygodnie |
| PHP 8.0/8.1 | bezpośrednio na 8.4 | dni–2 tygodnie |
| PHP 8.2/8.3 | bezpośrednio na 8.4/8.5 | dni |
Dokładny rozkład zmian między wersjami — co dokładnie przestaje działać na przejściu 7.4 → 8.0, 8.0 → 8.1, 8.1 → 8.2 i dalej — opisuję w artykule o migracji PHP 7.4 na 8.x.
Dla aplikacji na Laravel dochodzi osobny wymiar — migracja frameworka między wersjami, z własną kolejnością i pułapkami. Opisuję ją w artykule o aktualizacji Laravel krok po kroku. Migracja PHP i migracja frameworka mogą iść razem, ale wtedy plan musi być tym bardziej ostrożny.
Krok 1 — audyt zgodności
Zanim zmienisz cokolwiek, zmierz skalę problemu. Narzędzia do zgodności wersji pokazują dokładnie, które fragmenty kodu przestaną działać:
- PHPCompatibility — ruleset dla PHP_CodeSniffer, który skanuje kod pod kątem konstrukcji usuniętych albo zmienionych w nowych wersjach,
- PHPStan z regułami dla docelowej wersji — wychwytuje problemy typów i wywołań, które w nowej wersji staną się błędami,
- lista rozszerzeń — czy system korzysta z rozszerzeń, które zniknęły albo zmieniły API (np.
mysql_*usunięte w PHP 7), - zależności — sprawdzenie, które biblioteki mają wersje kompatybilne z docelowym PHP, a które są porzucone.
Audyt uruchamiasz kilkoma komendami — to najtańszy etap całej migracji
# 1. Skan zgodności z docelową wersją (PHPCompatibility)
composer require --dev phpcompatibility/php-compatibility
vendor/bin/phpcs -p . --standard=PHPCompatibility \
--runtime-set testVersion 8.4-
# 2. Analiza statyczna pod docelową wersję (PHPStan)
composer require --dev phpstan/phpstan
vendor/bin/phpstan analyse src --level=5
# 3. Przegląd zależności — które pakiety wspierają PHP 8.x
composer why-not php 8.4
Wynik audytu to lista blokad podzielona na kategorie: „do automatycznej naprawy", „do ręcznej decyzji", „do wymiany biblioteki". To jednocześnie plan migracji. Szerzej o tym etapie piszę w przewodniku o audycie kodu legacy.
Krok 2 — testy zabezpieczające
Migracja wersji PHP zmienia zachowanie systemu w miejscach, których nikt się nie spodziewa — od obsługi typów, przez sortowanie, po formatowanie liczb. Bez testów każdy taki efekt zobaczysz na produkcji.
Minimum to testy charakterystyczne na ścieżkach krytycznych: logowanie, zamówienie, płatność, generowanie dokumentów. Technikę ich pisania w starym kodzie opisuję w artykule o testach charakterystycznych. Testy uruchamiane w CI na docelowej wersji PHP zamieniają migrację z hazardu w proces z jasnymi kryteriami — zielone testy to warunek wdrożenia.
Jeśli projekt nie ma żadnych testów, nie zaczynaj od stuprocentowego pokrycia. Wystarczy 15–20 testów end-to-end na najważniejszych ścieżkach, żeby złapać większość regresji, które ujawnia zmiana wersji PHP.
Krok 3 — automatyczna refaktoryzacja z Rector
Ręczne poprawianie kodu pod nową wersję PHP to tygodnie pracy. Rector robi to automatycznie: ma gotowe rulesety dla przejść między wersjami (PHP 5.6 → 7.x → 8.x), które podmieniają usunięte funkcje, aktualizują składnię i modernizują konstrukcje do aktualnych standardów.
Minimalna konfiguracja dla skoku na PHP 8.4 wygląda tak
<?php
// rector.php
use Rector\Config\RectorConfig;
return RectorConfig::configure()
->withPaths([__DIR__ . '/src', __DIR__ . '/tests'])
->withPhpSets(php84: true); // kumulatywnie: 5.6 → 7.x → 8.0–8.4
Praktyka wdrożenia wygląda tak: uruchamiasz Rector z rulesetem dla najbliższego kroku, przeglądasz diff (mogą to być tysiące zmian — dlatego potrzebujesz testów), uruchamiasz testy, commitujesz. Kroki robisz wersja po wersji, a nie wszystko naraz — łatwiej wtedy przypisać ewentualne błędy do konkretnej zmiany. Pełny warsztat — rulesety, tryb dry-run, pułapki — opisuję w artykule o automatycznej migracji z Rector.
Rector nie naprawi wszystkiego — logika oparta na zachowaniach, które zmieniły się między wersjami (np. rzutowanie typów, funkcje sortujące), wymaga decyzji człowieka. Ale eliminuje 80–90% mechanicznej pracy. Techniki refaktoryzacji, które warto połączyć z migracją, opisuję w artykule o refaktoryzacji legacy code.
Krok 4 — staging i wdrożenie
Migrację wdrażasz tak samo jak każdą inną zmianę w procesie modernizacji: najpierw środowisko staging z realnymi danymi (na kopii), potem produkcja z monitoringiem.
- staging powinien działać na docelowej wersji PHP z tymi samymi rozszerzeniami co produkcja — różnice w konfiguracji to najczęstsze źródło „u mnie działa",
- wdrożenie produkcyjne rób poza szczytem ruchu i miej plan wycofania — stara wersja PHP zostaje na serwerze do czasu potwierdzenia stabilności,
- po wdrożeniu obserwuj logi błędów i wydajność przez kilka dni; deprecation warnings w logach to lista rzeczy do posprzątania w kolejnych iteracjach,
- dopiero po stabilizacji zaktualizuj zależności i framework do wersji docelowych — to drugi etap tej samej podróży.
Najprostszy sposób, żeby staging i produkcja miały identyczne środowisko, to konteneryzacja. Fragment docker-compose.yml z wersją PHP jako zmienną:
services:
app:
build:
context: .
args:
PHP_VERSION: "8.4" # staging i produkcja — ta sama wartość
volumes:
- .:/var/www/html
db:
image: mysql:8.0
Automatyzacja wdrożeń i testów na każdym etapie to nie luksus, lecz warunek bezpiecznej migracji — konfigurację opisuję w artykule o CI/CD i DevOps dla Laravel.
Co się najczęściej psuje przy migracji
Doświadczenie z projektów mówi, że problemy skupiają się w kilku miejscach
- funkcje usunięte między wersjami —
each(),create_function(), rozszerzeniemysql_*, stare APIpreg_replacez modifierem/e, - typy i rzutowanie — nowe wersje są surowsze; kod, który „przechodził", teraz rzuca błędami typów,
- null i puste wartości — przekazywanie null do funkcji oczekujących stringów to deprecation w 8.1 i błąd w przyszłych wersjach,
- dynamiczne właściwości — tworzenie właściwości „w locie" jest deprecjonowane od 8.2; kod, który na tym polega, wymaga refaktoryzacji,
- biblioteki porzucone — zależność, która nie ma wersji kompatybilnej z PHP 8, wymaga zamiany (to najczęściej najbardziej czasochłonny punkt migracji),
- zachowania brzegowe — sortowanie, porównywanie stringów numerycznych, formatowanie — miejsca, gdzie zmiany semantyki języka widać dopiero w testach.
Warto wiedzieć, że każda wersja wnosi własną porcję zmian — poniżej najważniejsze z punktu widzenia typowego projektu.
| Przejście | Najważniejsze zmiany |
|---|---|
| 7.4 → 8.0 | wyjątki zamiast warningów w wielu funkcjach, surowsze porównania stringów, usunięte each() i create_function(), zmiany w preg_* |
| 8.0 → 8.1 | deprecation null w parametrach nie-nullowalnych, readonly, enums, fibers |
| 8.1 → 8.2 | deprecation dynamicznych właściwości, deprecation części interpolacji stringów, readonly klasy |
| 8.2 → 8.3 | typowane stałe klas, deprecation get_class() bez argumentu |
| 8.3 → 8.4 | deprecation domyślnych wartości null w niejawnych parametrach, property hooks |
Żaden z tych punktów nie jest blokadą — każdy jest pozycją w planie. Groźne są tylko te, o których nie wiesz, że istnieją, dlatego audyt zgodności i testy są nie do pominięcia. Zmiany w swojej wersji sprawdzisz w oficjalnym przewodniku na php.net albo w zestawieniu na PHP.Watch.
Ile to trwa i ile kosztuje
Skala zależy od trzech zmiennych: liczby blokad z audytu, jakości testów i liczby porzuconych bibliotek. Orientacyjne widełki dla typowych projektów:
| Projekt | Zakres | Czas | Koszt (netto) |
|---|---|---|---|
| Mały | do ~20 tys. linii, brak egzotycznych zależności | 3–10 dni | 3 000 – 10 000 zł |
| Średni | framework, integracje, kilka porzuconych bibliotek | 2–8 tygodni | 10 000 – 40 000 zł |
| Duży / legacy | brak testów, własne rozszerzenia, wymiana bibliotek | 2–6 miesięcy | 40 000 zł+ (etapami) |
Największym zmiennym kosztem jest wymiana porzuconych bibliotek — jedna zależność bez wsparcia PHP 8 potrafi pochłonąć tydzień pracy, jeśli trzeba ją zastąpić własną implementacją albo znaleźć następcę. Drugim czynnikiem jest stan testów — projekt bez testów wymaga ich napisania przed migracją, co bywa połową całego budżetu. Pełne rozbicie kosztów — z etapami, TCO i wpływem rozmiaru zespołu — w artykule o koszcie migracji PHP.
Migrację PHP warto zaplanować jako część szerszego programu modernizacji — wtedy koszty rozkładają się na etapy, a każdy z nich dostarcza wartość: bezpieczeństwo, wydajność, nowsze biblioteki. Widełki całego programu i punkt startowy (audyt za 2 000 zł netto) opisuję w artykule o kosztach modernizacji legacy, a zakres usługi na stronie modernizacji legacy PHP. Cały plan działania — od audytu po CI/CD — w pillarze o modernizacji legacy code.
Przed startem warto przejść przez uporządkowaną listę kontrolną — od inwentaryzacji zależności po plan wycofania. 30 punktów do odhaczenia zebrałem w artykule z checklistą migracji PHP.
Najczęściej zadawane pytania
Czy mogę zaktualizować PHP bez zmian w kodzie?
W prostych projektach czasem wystarczy aktualizacja i testy, ale to wyjątek. Kod pisany pod PHP 5.6 czy 7.x zwykle korzysta z konstrukcji usuniętych albo zmienionych w nowszych wersjach. Standardowa ścieżka to audyt zgodności, refaktoryzacja z Rector i testy — dopiero potem wdrożenie. W projektach na WordPressie częściej wystarczy aktualizacja wtyczek i motywu, ale i tam zdarzają się własne modyfikacje wymagające poprawek — opisuję to w artykule o WordPress i PHP 8.
Czy migracja PHP wymaga zatrzymania systemu?
Nie. Migrację przygotowujesz na stagingu, a wdrożenie robisz jak każdą inną zmianę — poza szczytem, z możliwością wycofania. System nie musi być zatrzymywany na czas migracji; cała praca dzieje się poza produkcją, a na produkcji następuje tylko podmiana wersji. Stara wersja PHP zostaje na serwerze, dopóki nie potwierdzisz stabilności.
Od której wersji PHP zaczynać, jeśli system działa na 5.6?
Bezpieczna droga wiedzie przez wersję pośrednią — najczęściej 7.4 — potem 8.0/8.1 i docelowo 8.4 lub nowszą. Wersje pośrednie dają punkty kontrolne: po każdym kroku uruchamiasz testy i wdrażasz. Skok bezpośredni jest możliwy w prostych projektach, ale utrudnia diagnozę błędów — przy 5.6 różnice narosły przez trzy generacje języka.
Na którą wersję PHP migrować w 2026 roku?
Docelowo na PHP 8.4 lub 8.5 — to wersje z pełnym wsparciem. PHP 8.3 ma już tylko poprawki bezpieczeństwa (do końca 2027), a PHP 8.2 kończy wsparcie 31 grudnia 2026. Jeśli migrujesz z 5.6/7.x, nie zatrzymuj się na 8.0/8.1 — to wersje po EOL. Pełna tabela dat w artykule o wersjach PHP i datach wsparcia.
Czy aktualizacja PHP przyspieszy aplikację?
Zwykle tak, i to bez zmian w kodzie — nowsze wersje PHP są istotnie szybsze (optymalizacje silnika, JIT od 8.0). Realny zysk zależy od profilu aplikacji, ale przyspieszenie o kilkanaście–kilkadziesiąt procent nie jest rzadkością. Pełny efekt wydajnościowy wymaga też aktualizacji zależności i frameworka — sam interpreter to część układanki.
Ile trwa migracja PHP?
Mały projekt (kilkanaście tysięcy linii, bez egzotycznych zależności) przechodzi migrację w kilka dni. Średni system z frameworkiem i rozbudowanymi integracjami to typowo 2–8 tygodni, zależnie od liczby blokad i jakości testów. Duże systemy bez testów i z porzuconymi bibliotekami migruje się etapami przez kilka miesięcy.
Ile kosztuje migracja PHP?
Widełki dla typowych projektów to 3 000–10 000 zł netto (mały projekt), 10 000–40 000 zł (średni system) i od 40 000 zł wzwyż dla dużych systemów legacy rozliczanych etapami. Największe zmienne to wymiana porzuconych bibliotek i konieczność napisania testów przed migracją. Rozbicie kosztów na etapy opisuję w artykule o koszcie migracji PHP.
Czym jest Rector i czy zastąpi programistę?
Rector to narzędzie do automatycznej refaktoryzacji PHP — ma gotowe rulesety dla przejść między wersjami i potrafi zmechanizować 80–90% zmian, które inaczej robiłbyś ręcznie. Nie zastąpi programisty — nie naprawi logiki opartej na zmienionym zachowaniu języka ani nie wymieni porzuconej biblioteki. Skraca jednak migrację z tygodni do dni w części „mechanicznej".
Jak sprawdzić, czy kod jest zgodny z PHP 8?
- Trzema narzędziami: PHPCompatibility (skan konstrukcji usuniętych i zmienionych), PHPStan (problemy typów i wywołań, które w nowej wersji staną się błędami) oraz przeglądem zależności przez
composer why-not php 8.4. Wynik to lista blokad podzielona na automatyczne, ręczne i wymagające wymiany biblioteki — gotowy plan migracji.
Czy po migracji PHP trzeba też aktualizować biblioteki i framework?
Zwykle tak, ale w drugiej kolejności. Najpierw migrujesz interpreter i dostosowujesz kod, potem aktualizujesz zależności i framework do wersji docelowych. Część bibliotek wymaga nowszego PHP, więc ich aktualizacja stanie się możliwa dopiero po migracji — to druga faza tej samej pracy, nie osobny projekt.
Zobacz to w praktyce: Case study: modernizacja aplikacji PHP — krytyczny system PHP 5.6 przeniesiony na PHP 8.4 z Rector, testami regresji PHPUnit, CI/CD GitHub Actions i monitoringiem: zero krytycznych awarii przez 12 miesięcy, wdrożenia z 2 tygodni do 2 dni.