Aktualizacja Laravel — plan migracji krok po kroku (do wersji 12) [2026]

Aktualizacja Laravel to nie kwestia „czy", ale „kiedy". Laravel 10 zakończył wsparcie bezpieczeństwa w lutym 2025, a Laravel 11 kończy je w 2026 roku — aplikacje na niewspieranych wersjach nie dostają poprawek podatności i tracą wsparcie nowych pakietów. Dobrze zaplanowana migracja do Laravel 12 trwa zwykle 1–4 tygodnie i kosztuje orientacyjnie 5 000–30 000 zł netto + VAT, zależnie od rozmiaru projektu. W tym artykule znajdziesz plan migracji krok po kroku, listę narzędzi i najczęstsze pułapki.

Cykl wydania Laravel i wsparcie wersji

Laravel wydaje nową wersję co rok i utrzymuje dwie gałęzie wsparcia: poprawki błędów oraz poprawki bezpieczeństwa. Po zakończeniu wsparcia bezpieczeństwa wersja przestaje dostawać jakiekolwiek aktualizacje — także krytyczne łaty.

Jeśli Twoja aplikacja działa na Laravel 10 lub starszym, pracuje bez poprawek bezpieczeństwa — a to ryzyko, które rośnie z każdym miesiącem.

Dlaczego warto aktualizować Laravel?

• Bezpieczeństwo — nowe wersje dostają łaty podatności na bieżąco. Niewspierana wersja to otwarte drzwi, o których nie wiesz.
• Wydajność — nowsze wersje Laravel i PHP 8.4 przynoszą realne przyspieszenie bez zmian w kodzie.
• Wsparcie pakietów — biblioteki porzucają stare wersje frameworka. Im dłużej zwlekasz, tym więcej zależności wymaga wymiany.
• Rekrutacja i utrzymanie — programiści chcą pracować z aktualnym stackiem. Kod na Laravel 8 czy 9 utrudnia znalezienie wykonawcy.
• Koszty — migracja wykonana etapami jest tańsza niż ratunkowa aktualizacja po incydencie bezpieczeństwa.

Uwaga: Najczęstszy błąd to odkładanie aktualizacji „na spokojniejszy okres". Po dwóch–trzech latach przerwy migracja przestaje być aktualizacją, a staje się projektem modernizacji — z wymianą pakietów, przepisaniem modułów i testami regresji. Koszt rośnie wtedy kilkukrotnie.

Plan migracji Laravel krok po kroku

Sprawdzony proces, który stosujemy w projektach klienckich. Kolejność ma znaczenie — każdy krok zmniejsza ryzyko następnego.

• Audyt zależności — lista pakietów Composer i sprawdzenie, które wspierają wersję docelową. To najczęstsze źródło niespodzianek.
• Aktualizacja środowiska — PHP w wersji wymaganej przez nowy Laravel (dla wersji 12 zalecamy PHP 8.4), Docker, zależności systemowe.
• Testy przed migracją — jeśli projekt nie ma testów, najpierw powstają testy regresji na krytycznych ścieżkach (jak je pisać, opisuję w artykule o testach automatycznych w Laravel).
• Aktualizacja etapowa — Laravel pozwala przejść przez kolejne wersje po kolei (10 → 11 → 12), co upraszcza diagnozę błędów.
• Zmiany w kodzie — usunięcie wycofanych API, dostosowanie do nowych konwencji, aktualizacja konfiguracji.
• Aktualizacja pakietów — pojedynczo, z uruchomieniem testów po każdej zmianie.
• Statyczna analiza — PHPStan lub Larastan wychwytują problemy, których nie widzą testy.
• Testy na staging — pełny zestaw testów plus testy manualne krytycznych przepływów na środowisku zbliżonym do produkcji.
• Wdrożenie — najlepiej metodą małych kroków, z możliwością szybkiego rollbacku.
• Monitoring po wdrożeniu — logi błędów i alerty przez pierwsze dni po aktualizacji.

Dla typowego projektu cały proces to 1–4 tygodnie pracy. Projekty z rozbudowanymi integracjami i bez testów wymagają dłuższego planu.

Narzędzia, które przyspieszają aktualizację

• Laravel Shift — automatyczna aktualizacja szkieletu aplikacji, generuje pull requesty z potrzebnymi zmianami.
• Rector — automatyczna refaktoryzacja kodu PHP do nowszych standardów.
• PHPStan / Larastan — statyczna analiza wykrywająca błędy typów i wycofane konstrukcje.
• PHPUnit / Pest — testy, które po każdej zmianie mówią, czy aplikacja nadal działa.
• composer audit — skan znanych podatności w zależnościach.

Automatyzacja robi 70–80% mechanicznej pracy. Reszta to decyzje i weryfikacja — dlatego migracja bez testów jest możliwa, ale nieodpowiedzialna.

Najczęstsze pułapki migracji

• Pakiety bez wsparcia — porzucona biblioteka potrafi zablokować aktualizację. Czasem trzeba ją zastąpić własną implementacją albo nowszym odpowiednikiem.
• Brak testów — bez nich każda zmiana wymaga ręcznej weryfikacji, a ryzyko regresji rośnie lawinowo.
• Skok przez kilka wersji naraz — technicznie możliwy, ale znacznie trudniejszy w diagnozie niż aktualizacja etapowa.
• Pominięcie środowiska — aktualizacja PHP i zależności systemowych to część migracji, nie dodatek.
• Wdrożenie bez planu rollbacku — aktualizacja bez możliwości szybkiego powrotu to zakład, którego nie warto zawierać.

Ile trwa i ile kosztuje aktualizacja Laravel?

Orientacyjne koszty migracji, netto + VAT

Jeśli aplikacja przez lata narosła długiem technicznym, sama aktualizacja może nie wystarczyć — warto połączyć ją z porządkowaniem kodu. Zobacz, jak prowadzimy modernizację legacy PHP i case study modernizacji aplikacji.

Aktualizować czy przepisać od zera?

W 90% przypadków aktualizacja jest lepsza. Przepisanie od zera brzmi kusząco, ale oznacza miesiące pracy bez nowych funkcji, ryzyko utraty wiedzy biznesowej zaszytej w starym kodzie i ten sam dług techniczny odtworzony w nowym projekcie. Aktualizacja etapowa daje działającą aplikację po każdym kroku.

Przepisanie ma sens tylko wtedy, gdy architektura jest fundamentalnie błędna (np. system monolitowy do rozbicia na usługi) albo technologia wychodzi z użycia. Jak podjąć tę decyzję, opisałem w artykule modernizacja legacy code — plan działania.

Najczęściej zadawane pytania

Ile kosztuje aktualizacja Laravel?

Mała aplikacja to koszt 5 000–12 000 zł netto + VAT, średni projekt 12 000–25 000 zł, a duże systemy od 25 000 zł. Cena zależy przede wszystkim od liczby pakietów wymagających aktualizacji, pokrycia testami i stopnia skomplikowania integracji.

Ile trwa migracja do Laravel 12?

Typowo 1–4 tygodnie. Projekty z testami i aktualnymi pakietami przechodzą szybciej, projekty bez testów i z porzuconymi bibliotekami — dłużej. Etapowanie (10 → 11 → 12) wydłuża kalendarz, ale zmniejsza ryzyko i koszt diagnostyki błędów.

Czy Laravel 10 jest jeszcze wspierany?

Nie — wsparcie bezpieczeństwa Laravel 10 zakończyło się w lutym 2025 roku. Aplikacje na tej wersji nie dostają poprawek podatności. Laravel 11 kończy wsparcie w 2026 roku, a Laravel 12 jest wspierany do lutego 2027.

Co to jest Laravel Shift?

Laravel Shift to usługa automatycznej aktualizacji aplikacji Laravel — analizuje kod i generuje pull requesty z potrzebnymi zmianami. Przyspiesza migrację szkieletu i konfiguracji, ale nie zastępuje testów ani weryfikacji pakietów. Traktujemy go jako przyspieszacz, nie zamiennik procesu.

Czy można pominąć wersje przy aktualizacji?

Technicznie tak — z Laravel 9 można przejść od razu na 12. W praktyce aktualizacja etapowa jest bezpieczniejsza, bo każdy krok ma mniejszy zakres zmian i łatwiej przypisać błąd do konkretnej wersji. Przy dobrym pokryciu testami skok przez wersje bywa akceptowalny.

Kiedy zaplanować aktualizację Laravel?

Zanim wersja wyjdzie z wsparcia. Najlepszy moment to rok przed końcem wsparcia bezpieczeństwa — wtedy migracja jest planowana, a nie ratunkowa. Jeśli jesteś już po terminie, każdy miesiąc zwłoki zwiększa ryzyko i koszt.

👉 Masz aplikację na starszej wersji Laravel? Zamów bezpłatną konsultację — sprawdzimy zakres migracji. Napisz na kontakt@informatix.com.pl lub przez formularz.

📖 Zobacz również: testy automatyczne w Laravel, modernizacja legacy code oraz CI/CD i DevOps dla Laravel.