Zaktualizowali Państwo PHP na serwerze, a lokalnie projekt cofa się do wersji sprzed pięciu lat i połowa kodu wyrzuca ostrzeżenia o przestarzałych funkcjach. Albo odwrotnie: klient przesyła stronę na PHP 7.4, a w Państwa Laragonie działa tylko najnowsza wersja 8.5.

Laragon potrafi przechowywać kilka wersji PHP jednocześnie i przełączać się między nimi za pomocą kilku kliknięć. Bez kombinowania ze zmienną PATH, bez konfliktów i bez oddzielnej instalacji drugiego serwera WWW. Poniżej omawiamy oba sposoby: ręczny, który działa w każdej wersji Laragona, oraz automatyczny Quick Add dla wersji 8 i nowszych.

💡 Szybki przegląd:

• Proszę pobrać ZIP z potrzebną wersją PHP z windows.php.net, archiwum oznaczone jako Win32-vs16-x64 dla Apache
• Proszę rozpakować archiwum do C:\laragon\bin\php, nazwa folderu stanie się nazwą wersji w menu
• Proszę przełączyć wersję w zasobniku systemowym: prawy klik na ikonę, PHP, wybrana wersja, restart
• Dla Laragona 8+ proszę otworzyć Tools, Quick Add, PHP, a program sam pobierze i skonfiguruje potrzebną wersję

Krok 1: Pobieramy potrzebną wersję PHP

Oficjalne kompilacje PHP dla Windows znajdują się na windows.php.net. Aktualne wersje (8.2-8.5) są na głównej stronie. Jeśli projekt wymaga PHP 7.4, 8.0 lub 8.1, znajdują się one w archiwum.

Wybierając archiwum, proszę zwrócić uwagę na dwa parametry:

• Thread Safe (TS) lub Non-Thread Safe (NTS). Jeśli PHP działa jako moduł Apache, proszę wybrać TS. Dla Nginxa, wbudowanego serwera PHP lub uruchamiania z wiersza poleceń proszę wybrać NTS. Laragon domyślnie używa Apache, więc w większości przypadków odpowiedni będzie Win32-vs16-x64 (lub vs17 dla PHP 8.4+).

• Architektura. x64 dla 64-bitowego Windows, x86 dla 32-bitowego. W 2026 roku praktycznie wszędzie jest x64.

Przykład nazwy pliku dla PHP 8.3: php-8.3.31-Win32-vs16-x64.zip. Dla PHP 8.4 i 8.5 zmienił się kompilator, proszę szukać vs17 zamiast vs16.

Krok 2: Rozpakowujemy archiwum do folderu Laragona

Proszę wypakować ZIP do C:\laragon\bin\php\. Po rozpakowaniu pojawi się folder z numerem wersji, na przykład php-8.3.31-Win32-vs16-x64. Laragon odczytuje nazwę folderu i pokazuje ją w menu jako dostępną wersję.

Proszę nie zmieniać nazwy folderu. Jeśli wewnątrz ZIP-a znajduje się już zagnieżdżony folder, proszę użyć jego, a nie samego katalogu głównego archiwum. Struktura po rozpakowaniu powinna wyglądać następująco:

1
C:\laragon\bin\php\
2
  php-8.3.31-Win32-vs16-x64\
3
    php.exe
4
    php.ini-development
5
    ext\
6
    ...
7
  php-8.5.7-Win32-vs17-x64\
8
    ...

Krok 3: Przełączamy wersję w zasobniku systemowym

Proszę kliknąć prawym przyciskiem myszy ikonę Laragona w zasobniku systemowym, wskazać PHP i wybrać właśnie dodaną wersję. Laragon zrestartuje Apache z nową wersją, trwa to 2-3 sekundy.

Proszę sprawdzić, czy przełączenie zadziałało: proszę otworzyć Terminal w Laragonie (lub dowolny terminal, w którym ustawiona jest ścieżka do php.exe z C:\laragon\bin\php\) i wykonać:

1
php -v

W wyniku zobaczą Państwo numer wersji, datę kompilacji i typ (TS/NTS). Jeśli numer się nie zmienił, proszę sprawdzić, czy wybrano wersję w menu i zrestartowano Laragona.

Krok 4: Szybki sposób przez Quick Add (Laragon 8+)

Począwszy od Laragona 8 pojawił się Quick Add, wbudowany mechanizm, który sam pobiera, rozpakowuje i konfiguruje nowe wersje PHP. Żadnego ręcznego pobierania ze strony i kopiowania folderów.

Proszę otworzyć menu Laragona w zasobniku: Tools → Quick Add → PHP. Pojawi się lista dostępnych wersji, od 7.4 do 8.5. Proszę wybrać potrzebną, a Laragon zrobi całą resztę. W ciągu minuty wersja pojawi się w menu PHP i będzie gotowa do przełączenia.

Ten sposób jest lepszy: eliminuje błędy związane z wyborem TS/NTS i architektury. Quick Add sam określa odpowiedni wariant dla Państwa systemu.

Proces krok po kroku: wideo

Krótkie wideo, na którym cały proces jest pokazany od początku do końca, od pobrania PHP do przełączenia wersji w czasie rzeczywistym:

⁉️🤔 Często zadawane pytania

Jaka jest różnica między NTS a TS, którą wersję pobrać?

Dla Laragona z Apache proszę wybrać Thread Safe (TS, w nazwie pliku bez nts). Apache ładuje PHP jako moduł, a kompilacja TS zapewnia bezpieczeństwo wątkowe podczas równoległych zapytań. Non-Thread Safe (NTS) jest potrzebna, jeśli używają Państwo Nginxa lub uruchamiają PHP z wiersza poleceń. W praktyce z Laragonem proszę pobierać Win32-vs16-x64 dla PHP 8.0-8.3 i Win32-vs17-x64 dla PHP 8.4+.

Czy można przechowywać w Laragonie jednocześnie PHP 7.4, 8.2 i 8.5?

Tak, właśnie do tego służy obsługa wielu wersji. W folderze C:\laragon\bin\php\ może znajdować się wiele wersji, nie ma między nimi konfliktów, ponieważ w danym momencie Apache używa tylko jednej. Projekty na różnych wersjach nie przeszkadzają sobie nawzajem, o ile nie uruchamiają ich Państwo jednocześnie na jednym serwerze WWW.

Dodałem wersję, ale nie pojawia się ona w menu PHP. O co chodzi?

Po pierwsze: proszę sprawdzić, czy wewnątrz folderu z wersją znajduje się php.exe (a nie kolejny zagnieżdżony folder). Po drugie: proszę całkowicie zrestartować Laragona, Stop, a następnie Start All. Po trzecie: nazwa folderu musi różnić się od już istniejących, jeśli mają już Państwo php-8.3.31, proszę nie tworzyć drugiego takiego samego. I po czwarte: Quick Add sam konfiguruje wersję, jeśli pobierali Państwo ręcznie, a następnie ten sam numer przez Quick Add, stary folder zostanie nadpisany.

Co zrobić, jeśli po zmianie wersji PHP projekt nadal widzi starą?

Proszę otworzyć Terminal w Laragonie (prawy klik na ikonę → Terminal) i wykonać php -v, pokaże on wersję widzianą przez konsolę. Jeśli jest prawidłowa, a strona pokazuje inną, proszę wyczyścić pamięć podręczną przeglądarki i sprawdzić, czy nie jest buforowany php.ini z inną wartością. Czasami pomaga całkowite zatrzymanie Apache i ponowne uruchomienie.

Czy trzeba ponownie uruchamiać komputer po dodaniu wersji?

Nie. Laragon restartuje tylko Apache, trwa to 2-3 sekundy. Ponowne uruchomienie Windows może być potrzebne tylko w jednym przypadku: jeśli ręcznie dodawali Państwo ścieżkę do php.exe do systemowej zmiennej PATH i Windows zapisał w pamięci podręcznej starą ścieżkę. Jednak przy normalnym korzystaniu z Laragona nie jest to potrzebne.

Czy warto zaktualizować Laragona ze względu na obsługę wielu wersji?

Jeśli nadal korzystają Państwo z Laragona 6 lub 7, aktualizacja do wersji 8.6 daje nie tylko Quick Add. W zestawie dostępne są od razu PHP 8.1-8.5, Apache 2.4.66, MySQL 9.6 oraz automatyczne aktualizacje komponentów przez menu. Migracja z WAMP lub XAMPP również nie jest skomplikowana: oficjalna instrukcja opisuje migrację w 5 minut.

W przypadku projektów uzależnionych od konkretnej wersji PHP obsługa wielu wersji w Laragonie jest jednym z głównych argumentów przemawiających na jego korzyść. Przełączyli się Państwo, sprawdzili, wrócili do poprzedniej i żadna strona nie uległa uszkodzeniu.

Proszę zacząć od Quick Add: proszę otworzyć Tools → Quick Add → PHP i zainstalować brakującą wersję w minutę. A jeśli mają Państwo sprawdzony trik dotyczący pracy z wersjami PHP w Laragonie, proszę podzielić się nim w komentarzach.