Jak zmienić wersję PHP w swoim środowisku hostingowym (Kompletny przewodnik)

Zarządzanie wersją PHP jest jednym z najważniejszych zadań administracyjnych dla każdego właściciela witryny lub dewelopera. Niezależnie od tego, czy uaktualniasz się, aby skorzystać z najnowszych ulepszeń wydajności, obniżasz wersję dla kompatybilności starszych aplikacji, czy też naprawiasz luki w zabezpieczeniach, wiedza na temat dokładnego przełączania wersji PHP w różnych środowiskach hostingowych jest umiejętnością niezbędną. Ten kompleksowy przewodnik przeprowadzi Cię przez każdą dostępną metodę — od graficznego interfejsu cPanel po narzędzia wiersza poleceń na VPS Hosting i serwerach dedykowanych.

1. Dlaczego zarządzanie wersją PHP jest ważne

PHP napędza ponad 77% wszystkich witryn z znanym językiem po stronie serwera, w tym główne platformy takie jak WordPress, Joomla, Drupal i Magento. Każde główne wydanie PHP wprowadza znaczące zmiany:

• Wzrost wydajności: PHP 8.x jest dramatycznie szybsze niż PHP 5.x lub 7.x, dzięki kompilatorowi JIT (Just-In-Time).
• Poprawki bezpieczeństwa: Starsze wersje PHP ostatecznie osiągają koniec życia (EOL) i nie otrzymują już aktualizacji bezpieczeństwa, narażając Twoją witrynę na zagrożenia.
• Kompatybilność aplikacji: Niektóre starsze wtyczki, motywy lub aplikacje niestandardowe zostały napisane dla określonych wersji PHP i mogą ulec awarii w nowszych wydaniach.
• Zgodność hostingu: Wielu dostawców hostingu wymusza minimalne wymagania dotyczące wersji PHP, aby utrzymać standardy bezpieczeństwa serwera.

Brak proaktywnego zarządzania wersją PHP może skutkować uszkodzeniem funkcjonalności, naruszeniami bezpieczeństwa lub całkowitym przestojem witryny. Zrozumienie, jak kontrolować to ustawienie — niezależnie od typu hostingu — jest niezbędne dla każdego poważnego administratora sieci.

2. Zrozumienie wersji PHP i kompatybilności

Przed wprowadzeniem jakichkolwiek zmian ważne jest zrozumienie cyklu wydań PHP i sposobu strukturyzacji wersji.

Numerowanie wersji PHP

PHP stosuje schemat wersjonowania MAJOR.MINOR.PATCH:

Cykl wsparcia PHP

Każda wersja minor PHP otrzymuje:

• Aktywne wsparcie przez około 2 lata (poprawki błędów + łatki bezpieczeństwa)
• Wsparcie tylko bezpieczeństwa przez dodatkowy 1 rok
• Koniec życia (EOL), po którym nie są wydawane żadne łatki

Aktualnie obsługiwane wersje PHP (od 2024–2025)

> Praktyczna zasada: Zawsze uruchamiaj najwyższą wersję PHP, którą oficjalnie obsługuje Twoja aplikacja. Jeśli Twój CMS lub framework obsługuje PHP 8.2, nie ma powodu, aby uruchamiać PHP 7.4.

3. Metoda 1: Zmiana wersji PHP za pośrednictwem cPanel (MultiPHP Manager)

cPanel to najczęściej używany panel sterowania hostingiem i zapewnia dwa wbudowane narzędzia do zarządzania wersją PHP: MultiPHP Manager (na poziomie serwera lub dla każdej domeny) i MultiPHP INI Editor (do precyzyjnego dostrajania ustawień PHP). Jeśli używasz VPS z cPanel, oba narzędzia są dla Ciebie dostępne.

Krok 1: Zaloguj się do cPanel

1. Otwórz przeglądarkę i przejdź do adresu URL logowania cPanel:

https://yourdomain.com:2083 (bezpieczny, zalecany)
https://yourdomain.com/cpanel

1. Wpisz swoją nazwę użytkownika cPanel i hasło.
2. Kliknij Zaloguj się.

Krok 2: Otwórz MultiPHP Manager

1. Na pulpicie cPanel przewiń do sekcji Oprogramowanie.
2. Kliknij na MultiPHP Manager.

> Alternatywa: Niektóre konfiguracje cPanel oznaczają to jako Wybierz wersję PHP, Konfiguracja PHP lub Selektor PHP (ta ostatnia jest powszechna w hostingu współdzielonym opartym na CloudLinux). Interfejs może się nieznacznie różnić, ale proces jest taki sam.

Krok 3: Wybierz domenę i wersję PHP

W interfejsie MultiPHP Manager:

1. Zobaczysz listę wszystkich domen i poddomen hostowanych na Twoim koncie.
2. Zaznacz pole wyboru obok domeny, którą chcesz zmodyfikować.
3. Z menu rozwijanego Wersja PHP u góry strony wybierz żądaną wersję PHP (np. PHP 8.2).
4. Kliknij Zastosuj.

> Ważne: Jeśli masz konto hostingu współdzielonego, dostępne wersje PHP są określane przez dostawcę hostingu. Jeśli potrzebujesz wersji, która nie jest wymieniona, skontaktuj się z zespołem wsparcia hosta lub rozważ upgrade do planu Hosting VPS, gdzie masz pełną kontrolę nad zainstalowanymi wersjami PHP.

Krok 4: (Opcjonalnie) Dostosuj ustawienia PHP za pośrednictwem MultiPHP INI Editor

Po przełączeniu wersji może być konieczne dostosowanie wartości konfiguracji PHP:

1. Wróć do sekcji Oprogramowanie w cPanel.
2. Kliknij MultiPHP INI Editor.
3. Wybierz domenę z menu rozwijanego.
4. Zmodyfikuj wartości takie jak:

memory_limit (np. 256M)
upload_max_filesize (np. 64M)
max_execution_time (np. 300)
post_max_size (np. 64M)


Kliknij Zastosuj, aby zapisać zmiany.

Krok 5: Sprawdź zmianę
Utwórz plik testowy, aby potwierdzić aktywną wersję PHP (pełne instrukcje znajdują się w sekcji 7).
4. Metoda 2: Zmiana wersji PHP poprzez .htaccess (Apache)
Jeśli Twoje środowisko hostingowe korzysta z Apache, ale nie udostępnia graficznego selektora PHP, możesz kontrolować wersję PHP bezpośrednio poprzez plik .htaccess. Ta metoda jest szczególnie przydatna w planach Shared Web Hosting, gdzie dostęp na poziomie serwera jest ograniczony.
Jak to działa
Apache używa handlerów do określenia sposobu przetwarzania plików .php. Poprzez określenie niestandardowego handlera w .htaccess, instruujesz Apache’a, aby używał określonej wersji PHP dla Twojej witryny.
Krok 1: Dostęp do pliku .htaccess
Możesz edytować .htaccess poprzez:

Menedżer plików cPanel: Przejdź do public_html, znajdź .htaccess, kliknij prawym przyciskiem myszy i wybierz Edytuj.
Klient FTP/SFTP: Połącz się z serwerem i przejdź do katalogu głównego witryny (zwykle public_html lub www).
Wiersz poleceń SSH: nano /home/username/public_html/.htaccess

> Uwaga: .htaccess jest plikiem ukrytym. W kliencie FTP włącz opcję „Pokaż pliki ukryte”. W Menedżerze plików cPanel zaznacz „Pokaż pliki ukryte (dotfiles)” w ustawieniach w prawym górnym rogu.

Krok 2: Dodaj dyrektywę handlera PHP

Dodaj jedną z poniższych linii do pliku .htaccess, w zależności od konwencji nazewnictwa handlera PHP na Twoim serwerze:

Dla PHP 8.2:

AddHandler application/x-httpd-php82 .php

Dla PHP 8.1:

AddHandler application/x-httpd-php81 .php

Dla PHP 7.4 (legacy):

AddHandler application/x-httpd-php74 .php

Alternatywna składnia (używana na niektórych hostach):

# Using suPHP or FastCGI
Action php-cgi /cgi-bin/php82
AddHandler php-cgi .php

> Ważne: Dokładna nazwa handlera (x-httpd-php82, x-httpd-php81 itd.) zależy od sposobu, w jaki Twój dostawca hostingu skonfigurował PHP na swoich serwerach. Jeśli powyższe nie zadziała, sprawdź dokumentację swojego hosta lub skontaktuj się z pomocą techniczną, aby uzyskać prawidłowe nazwy handlerów.

Krok 3: Zapisz i przetestuj

Zapisz plik .htaccess i przetestuj swoją witrynę. Jeśli zobaczysz błąd 500 Internal Server Error, nazwa handlera jest prawdopodobnie nieprawidłowa — usuń linię i spróbuj alternatywnej składni.

5. Metoda 3: Zmiana wersji PHP przez wiersz poleceń (VPS/Serwery dedykowane)

Jeśli zarządzasz własnymi Dedicated Servers lub VPS z dostępem root, masz pełną kontrolę nad instalacją PHP i przełączaniem wersji. To jest najpotężniejsza i najbardziej elastyczna metoda.

Wymagania wstępne

• Dostęp root lub sudo do serwera
• Klient SSH (Terminal na macOS/Linux, PuTTY lub Windows Terminal na Windows)
• Podstawowa znajomość operacji wiersza poleceń Linux

Ubuntu / Debian — Używanie update-alternatives

Systemy oparte na Ubuntu i Debian używają update-alternatives do zarządzania wieloma wersjami PHP jednocześnie.

Krok 1: Dodaj repozytorium PHP Ondřeja Surého

Ten PPA zapewnia wiele wersji PHP dla Ubuntu/Debian:

sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

Krok 2: Zainstaluj żądaną wersję PHP

# Install PHP 8.2 and common extensions
sudo apt install -y php8.2 php8.2-cli php8.2-fpm php8.2-mysql php8.2-curl 
    php8.2-gd php8.2-mbstring php8.2-xml php8.2-zip php8.2-bcmath

# Install PHP 8.1 if needed
sudo apt install -y php8.1 php8.1-cli php8.1-fpm php8.1-mysql

Krok 3: Przełącz domyślną wersję PHP (CLI)

# View all registered PHP alternatives
sudo update-alternatives --list php

# Switch to PHP 8.2
sudo update-alternatives --set php /usr/bin/php8.2

# Or use the interactive selector
sudo update-alternatives --config php

Interaktywny selektor wyświetli coś takiego:

There are 3 choices for the alternative php (providing /usr/bin/php).

  Selection    Path             Priority   Status
------------------------------------------------------------
* 0            /usr/bin/php8.2   82        auto mode
  1            /usr/bin/php7.4   74        manual mode
  2            /usr/bin/php8.1   81        manual mode
  3            /usr/bin/php8.2   82        manual mode

Press <enter> to keep the current choice[*], or type selection number:

Wpisz numer odpowiadający żądanej wersji i naciśnij Enter.

Krok 4: Przełącz wersję PHP dla Apache (mod_php)

# Disable current PHP module (e.g., PHP 8.1)
sudo a2dismod php8.1

# Enable new PHP module (e.g., PHP 8.2)
sudo a2enmod php8.2

# Restart Apache
sudo systemctl restart apache2

Krok 5: Przełącz wersję PHP dla Nginx (PHP-FPM)

W przypadku Nginx, PHP jest obsługiwany przez PHP-FPM. Zaktualizuj blok serwera Nginx, aby wskazywał na prawidłowe gniazdo FPM:

# In your Nginx server block configuration
location ~ .php$ {
    fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

Następnie uruchom ponownie zarówno PHP-FPM, jak i Nginx:

sudo systemctl restart php8.2-fpm
sudo systemctl restart nginx

CentOS / RHEL / AlmaLinux / Rocky Linux — Używanie repozytorium SCL lub Remi

Opcja A: Używanie Software Collections (SCL) — CentOS 7

# Install the SCL repository
sudo yum install -y centos-release-scl

# Install PHP 7.4 via SCL
sudo yum install -y rh-php74 rh-php74-php-fpm rh-php74-php-mysqlnd

# Enable PHP 7.4 for the current session
sudo scl enable rh-php74 bash

# Verify
php --version

> Uwaga: Zmiany SCL są specyficzne dla sesji. Aby uczynić je trwałymi dla użytkownika, dodaj source /opt/rh/rh-php74/enable do ~/.bashrc.

Opcja B: Używanie repozytorium Remi — CentOS 7/8, AlmaLinux, Rocky Linux

# Install EPEL and Remi repositories
sudo dnf install -y epel-release
sudo dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm  # For RHEL 8/AlmaLinux 8

# List available PHP streams
sudo dnf module list php

# Reset current PHP module
sudo dnf module reset php

# Enable PHP 8.2 stream
sudo dnf module enable php:remi-8.2

# Install PHP 8.2
sudo dnf install -y php php-cli php-fpm php-mysqlnd php-gd php-mbstring php-xml php-zip

# Verify
php --version

Przełączanie PHP dla poszczególnych witryn (wersja PHP dla każdej witryny)

Na serwerach obsługujących wiele witryn internetowych, często potrzebne są różne wersje PHP dla każdej witryny. Najczystszym podejściem jest uruchomienie wielu pul PHP-FPM:

# Start PHP-FPM for multiple versions
sudo systemctl start php7.4-fpm
sudo systemctl start php8.1-fpm
sudo systemctl start php8.2-fpm

Następnie skonfiguruj każdy wirtualny host Nginx, aby używał innego gniazda FPM:

# Site A — PHP 8.2
server {
    server_name site-a.com;
    root /var/www/site-a;
    location ~ .php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
    }
}

# Site B — PHP 7.4 (legacy application)
server {
    server_name site-b.com;
    root /var/www/site-b;
    location ~ .php$ {
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
    }
}

6. Metoda 4: Zmiana wersji PHP za pośrednictwem php.ini

W niektórych środowiskach hostingowych, szczególnie tych używających obsługi PHP CGI lub FastCGI, możesz wpływać na zachowanie PHP — a czasami nawet na wersję — poprzez niestandardowy plik php.ini umieszczony w katalogu głównym Twojej witryny.

Tworzenie niestandardowego php.ini

1. Utwórz plik o nazwie php.ini w katalogu głównym Twojej witryny (public_html).
2. Dodaj swoje dyrektywy konfiguracyjne:

; Custom PHP configuration
memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
max_input_vars = 3000
date.timezone = "UTC"

> Uwaga: Ta metoda kontroluje *ustawienia* PHP, niekoniecznie samą *wersję* PHP. Wybór wersji za pośrednictwem php.ini jest możliwy tylko w określonych konfiguracjach hostingowych. Aby uzyskać pełną kontrolę nad wersją, użyj cPanel, .htaccess lub metod wiersza poleceń opisanych powyżej.

7. Jak zweryfikować aktywną wersję PHP

Po dokonaniu jakichkolwiek zmian zawsze sprawdź, czy aktywna jest prawidłowa wersja PHP. Istnieje kilka sposobów, aby to zrobić:

Metoda A: Utwórz stronę testową phpinfo()

1. Utwórz nowy plik o nazwie phpinfo.php w katalogu głównym witryny (public_html).
2. Dodaj następującą zawartość:

<?php
phpinfo();
?>

1. Przejdź do https://yourdomain.com/phpinfo.php w przeglądarce.
2. Strona wyświetli kompleksowe informacje o konfiguracji PHP. Wersja PHP jest wyświetlana na samej górze.

> Ostrzeżenie bezpieczeństwa: Usuń ten plik natychmiast po testowaniu. Dane wyjściowe phpinfo() ujawniają wrażliwe szczegóły konfiguracji serwera, które mogą pomóc atakującym.

Metoda B: Sprawdzenie za pomocą wiersza poleceń (SSH)

php --version
# or
php -v

Oczekiwane dane wyjściowe:

PHP 8.2.10 (cli) (built: Sep  5 2023 08:12:49) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.10, Copyright (c) Zend Technologies
    with Zend OPcache v8.2.10, Copyright (c), by Zend Technologies

Metoda C: Sprawdzenie za pomocą prostego skryptu PHP

Aby uzyskać mniej szczegółowe sprawdzenie, użyj tego minimalnego skryptu zamiast pełnego phpinfo():

<?php
echo 'PHP Version: ' . PHP_VERSION;
echo '<br>PHP Major Version: ' . PHP_MAJOR_VERSION;
echo '<br>PHP Minor Version: ' . PHP_MINOR_VERSION;
?>

Metoda D: Sprawdzenie za pomocą panelu administracyjnego WordPress (dla witryn WordPress)

Na pulpicie nawigacyjnym WordPress:

1. Przejdź do Narzędzia → Kondycja witryny.
2. Kliknij kartę Informacje.
3. Rozwiń sekcję Serwer.
4. Poszukaj wersji PHP.

8. Typowe błędy po zmianie wersji PHP

Zmiana wersji PHP może czasami powodować problemy. Oto najczęstsze problemy i sposoby ich rozwiązania:

Błąd 1: White Screen of Death (WSOD) lub pusta strona

Przyczyna: Wtyczka, motyw lub niestandardowy kod używa składni lub funkcji, które są niezgodne z nową wersją PHP.

Rozwiązanie:

• Włącz tryb debugowania WordPress, dodając do wp-config.php:

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  define('WP_DEBUG_DISPLAY', false);

• Sprawdź /wp-content/debug.log w poszukiwaniu konkretnych komunikatów błędów.
• Wyłącz wszystkie wtyczki i przełącz się na domyślny motyw, aby wyizolować problem.

Błąd 2: 500 Internal Server Error

Przyczyna: Często spowodowany nieprawidłowym obsługiwaczem PHP w .htaccess lub rozszerzeniem PHP, które nie jest zainstalowane dla nowej wersji.

Rozwiązanie:

• Usuń lub popraw dyrektywę AddHandler w .htaccess.
• Sprawdź dziennik błędów serwera: tail -f /var/log/apache2/error.log lub tail -f /var/log/nginx/error.log.
• Upewnij się, że wymagane rozszerzenia PHP są zainstalowane dla nowej wersji.

Błąd 3: “Call to undefined function” lub “Class not found”

Przyczyna: Rozszerzenie PHP wymagane przez Twoją aplikację (np. php-gd, php-mbstring, php-xml) nie jest zainstalowane dla nowej wersji PHP.

Rozwiązanie:

# Ubuntu/Debian — install missing extensions for PHP 8.2
sudo apt install php8.2-gd php8.2-mbstring php8.2-xml php8.2-curl php8.2-zip

# Restart web server
sudo systemctl restart apache2  # or nginx

Błąd 4: Ostrzeżenia o przestarzałych funkcjach

Przyczyna: Twój kod używa funkcji, które zostały wycofane w starszych wersjach PHP i usunięte w nowszych (np. funkcje mysql_* usunięte w PHP 7.0).

Rozwiązanie:

• Zaktualizuj swój kod lub wtyczki, aby używać nowoczesnych odpowiedników (np. mysqli_* lub PDO).
• Jeśli natychmiastowe zmiany kodu nie są możliwe, rozważ tymczasowe pozostanie na zgodnej wersji PHP, podczas gdy planujesz uaktualnienie.

Błąd 5: Wersja PHP nie zmienia się pomimo wykonania kroków

Przyczyna: Może obowiązywać wiele konfiguracji PHP (np. CLI vs. serwer WWW) lub pamięć podręczna serwuje stare odpowiedzi.

Rozwiązanie:

• Wyczyść pamięć podręczną przeglądarki i wszelkie pamięci podręczne po stronie serwera (OPcache, Redis, Varnish).
• Uruchom ponownie serwer WWW: sudo systemctl restart apache2 lub sudo systemctl restart nginx.
• Potwierdź, że edytujesz prawidłowy .htaccess lub plik konfiguracyjny dla właściwej domeny.

9. Najlepsze praktyki zarządzania wersjami PHP

Postępuj zgodnie z poniższymi wytycznymi, aby utrzymać zdrowe, bezpieczne i wydajne środowisko PHP:

1. Zawsze najpierw testuj w środowisku przejściowym

Nigdy nie przełączaj wersji PHP bezpośrednio na aktywnej witrynie produkcyjnej. Skonfiguruj środowisko przejściowe — subdomenę lub osobny serwer — i dokładnie przetestuj swoją aplikację przed zastosowaniem zmian w produkcji.

2. Utrzymuj PHP w aktualnym stanie

Subskrybuj oficjalne ogłoszenia bezpieczeństwa PHP i zaplanuj uaktualnienia, zanim Twoja obecna wersja osiągnie koniec okresu wsparcia. Uruchamianie wersji PHP, które nie są już wspierane, jest jedną z najczęstszych przyczyn kompromisów witryn.

3. Sprawdź kompatybilność wtyczek i zależności przed uaktualnieniem

Przed uaktualnieniem PHP sprawdź kompatybilność:

• Wszystkich zainstalowanych wtyczek i motywów CMS
• Zależności Composer (composer.json)
• Niestandardowego kodu aplikacji

Użyj narzędzi takich jak PHPCompatibility (zestaw reguł PHP_CodeSniffer) do skanowania bazy kodu pod kątem problemów kompatybilności.

4. Utrzymuj rozszerzenia PHP w synchronizacji

Podczas przełączania wersji PHP zawsze przeinstaluj wszystkie wymagane rozszerzenia dla nowej wersji. Brakujące rozszerzenie jest najczęstszą przyczyną błędów po uaktualnieniu.

5. Używaj kontroli wersji dla plików konfiguracyjnych

Przechowuj swoje .htaccess, php.ini i pliki konfiguracji serwera w repozytorium Git. Ułatwia to wycofanie zmian, jeśli coś pójdzie nie tak.

6. Monitoruj po przełączeniu

Po zmianie wersji PHP monitoruj:

• Dzienniki błędów aplikacji
• Dzienniki błędów serwera (/var/log/apache2/error.log, /var/log/nginx/error.log)
• Metryki wydajności aplikacji
• Alerty monitorowania czasu dostępności

7. Wybierz odpowiedni hosting dla elastyczności PHP

Jeśli stale ograniczają Cię opcje PHP w środowisku hostingu, może być czas na uaktualnienie. Plany Hosting Współdzielony oferują wyselekcjonowany zestaw wersji PHP zarządzanych przez dostawcę, podczas gdy Hosting VPS daje Ci pełną swobodę instalacji, konfiguracji i przełączania dowolnej wersji PHP w dowolnym momencie. Aby uzyskać kontrolę na poziomie przedsiębiorstwa i wydajność, Serwery Dedykowane zapewniają ostateczną elastyczność.

10. Podsumowanie

Zmiana wersji PHP to fundamentalne zadanie zarządzania hostingiem, które bezpośrednio wpływa na bezpieczeństwo, wydajność i kompatybilność Twojej witryny. Niezależnie od tego, czy używasz cPanel MultiPHP Manager, edytujesz dyrektywy .htaccess, czy zarządzasz instalacjami PHP za pośrednictwem wiersza poleceń na VPS lub serwerze dedykowanym, kluczowe zasady pozostają takie same: testuj przed wdrożeniem, weryfikuj po zmianie i zawsze utrzymuj wersję PHP w aktywnym cyklu życia.

Oto szybkie podsumowanie omówionych metod:

Jeśli szukasz środowiska hostingowego, które ułatwia zarządzanie wersją PHP i daje Ci potrzebną kontrolę, zapoznaj się z planami VPS Hosting AlexHost — oferującymi pełny dostęp root, wiele dystrybucji Linux i elastyczność do uruchamiania dowolnej wersji PHP wymaganej przez Twoje aplikacje. Możesz również zapoznać się z naszą ofertą Paneli sterowania VPS, aby znaleźć interfejs zarządzania, który najlepiej odpowiada Twojemu przepływowi pracy.

Bądź proaktywny w aktualizacjach PHP, a Twoje witryny pozostaną szybkie, bezpieczne i kompatybilne przez wiele lat.