Wtyczka wymaga nowszego PHP, niż masz
Włączona wtyczka wymaga nowszego PHP, niż ma serwer. Dziś nic się nie psuje. Błąd pojawi się przy pierwszym fragmencie kodu, którego to PHP nie obsłuży.
Objaw
Wtyczka włączyła się bez sprzeciwu i działa od miesięcy. W jej nagłówku jest Requires PHP: 8.1.
Serwer ma 8.0. Nic w sklepie nie wygląda źle.
WordPress sprawdza to wymaganie przy instalacji i aktualizacji z panelu oraz przy włączaniu wtyczki. Wtyczki już włączonej nie sprawdza ponownie. Wystarczy więc, że hosting obniży wersję PHP, sklep trafi na serwer ze starszym PHP razem z listą włączonych wtyczek albo nowa wersja wtyczki zostanie wgrana z pominięciem panelu, na przykład przez FTP.
Ile to kosztuje
Niezgodne PHP nie psuje sklepu stopniowo. Psuje go przy pierwszym żądaniu, które dojdzie do kodu napisanego dla nowszej wersji, a błąd składni w PHP jest krytyczny:
- Awaria to biały ekran, a nie spowolnienie. PHP nie umie wczytać pliku w części. Strona, która korzysta z tego pliku, zwraca błąd 500, a jeśli plik wczytuje się przy każdym żądaniu, pada cały sklep.
- Czeka na rzadko używany kod. Nowa składnia może być w obsłudze zwrotów, w liczeniu podatku dla jednego kraju albo na ekranie, który otwierasz dwa razy do roku. Dlatego jeszcze nic się nie stało.
- Najpewniej wyjdzie przy aktualizacji. Aktualizacja wtyczki przynosi nowy kod, więc awaria przyjdzie najpewniej w chwili, w której i tak coś zmieniasz.
- Liczy się miejsce. Jeśli błąd krytyczny jest w płatności albo w koszyku, dowiesz się o nim od klientów.
Jak to sprawdzić samodzielnie
Najprościej w panelu: Wtyczki → Zainstalowane wtyczki. Pod wtyczką, której wymaganie jest wyższe niż PHP serwera, WordPress pisze: „Wtyczka nie działa z używaną wersją PHP.”
Z wiersza poleceń: PHP podaje własną wersję, a WP-CLI listę włączonych wtyczek:
php -r 'echo PHP_VERSION, "\n";'
wp plugin list --status=active --fields=name,version --format=table
Samo wymaganie jest w nagłówku głównego pliku każdej wtyczki:
grep -ri "Requires PHP" wp-content/plugins/*/*.php | grep -v "Requires PHP: *$"
Porównaj każdy wynik z wersją PHP, na której działa sklep. php -r pokazuje wersję PHP wiersza
poleceń, a ta bywa inna niż wersja serwera WWW. Wersję serwera WWW zobaczysz w panelu:
Narzędzia → Stan witryny → Informacja → Serwer.
Jak naprawić
- Podnieś PHP, zamiast cofać wtyczkę. Sklep na PHP 8.0 jest już poza okresem, w którym ta wersja dostawała poprawki bezpieczeństwa.
- Najpierw sprawdź na kopii testowej, ze wszystkimi wtyczkami włączonymi. Błędy, których szukasz, pojawiają się tylko na niektórych ekranach.
- Jeśli wtyczka nie działa na nowszym PHP, to ją trzeba wymienić, a nie serwer. Wtyczka, która nie nadąża za PHP, nie jest utrzymywana.
- Sprawdzaj po każdej przeprowadzce sklepu. Przeniesienie sklepu na nowy hosting to jedna z typowych dróg do tej niezgodności.
Kiedy to fałszywy alarm
- Wtyczki z błędnym albo nieaktualnym nagłówkiem. Część autorów podnosi
Requires PHPna zapas, zanim naprawdę użyje nowszej składni. Taki nagłówek to obietnica wsparcia, a nie zawsze wymaganie techniczne. - Kod, który w Twoim sklepie nigdy się nie wykonuje, na przykład wtyczka, której nowsza składnia jest tylko w integracji, której nie włączono.
- Inne PHP dla wiersza poleceń i dla serwera WWW. Skan uruchomiony w panelu działa zwykle na PHP serwera WWW. Skan uruchomiony z WP-CLI porównuje z PHP wiersza poleceń, więc może zgłosić wtyczkę, która w sklepie działa bez problemu, albo przeoczyć odwrotny przypadek.
Jak znajduje to Merchlint
Merchlint odczytuje nagłówek Requires PHP każdej włączonej wtyczki, także włączonej dla całej
sieci w instalacji wielowitrynowej, i porównuje go z wersją PHP, na której działa skan. Skan
uruchomiony w panelu zwykle działa na PHP serwera WWW. Skan uruchomiony z WP-CLI używa PHP wiersza
poleceń, a to bywa inna wersja. Każda wtyczka z wyższym wymaganiem to osobny wynik: nazwa wtyczki,
jej plik, wymagana wersja PHP i wersja, na której działał skan.
Wtyczek bez nagłówka Requires PHP Merchlint nie zgłasza: WordPress uznaje je za zgodne i Merchlint
robi tak samo. Motywów nie sprawdza.
Pewność: F — fakt ze środowiska. Jeden numer wersji jest niższy od drugiego.
Ta kontrola jest w dodatku Pro, który jeszcze przygotowujemy. Darmowa wtyczka jej nie uruchamia.
Zainstaluj za darmoCoś się nie zgadza z tym, co widzisz w sklepie? Napisz do nas. Czytamy każdą wiadomość. contact@merchlint.com
Masz wynik z wtyczki i nie wiesz, od czego zacząć? Do 30 listopada 2026 przeglądamy eksporty z dziesięciu sklepów — darmowy audyt katalogu.