Jak naprawić błędy krytyczne w WordPressie?

Gdy masz już dostęp do plików strony, trzeba znaleźć przyczynę błędu. Najłatwiej to zrobić włączając tryb debugowania WordPressa. Domyślnie jest on wyłączony – dla bezpieczeństwa, żeby nie ujawniać za dużo informacji o „zapleczu” witryny.

Aby go uruchomić:

• otwórz plik wp-config.php, który znajduje się w głównym katalogu instalacji WordPressa;
• znajdź linijkę:

define( 'WP_DEBUG', false );

• zastąp ją wpisem:

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

Bardzo ważne, aby wpis wyglądał dokładnie tak, jak wyżej!

WP\_DEBUG\_LOG zapisuje błędy do pliku /wp-content/debug.log na serwerze, do którego tylko Ty masz dostęp. Natomiast jeśli ustawiłbyś na true również WP\_DEBUG\_DISPLAY, wtedy dokładna informacja o błędzie pojawiłaby się… w komunikacie na stronie, więc każdy mógłby ją przeczytać.

Po zapisaniu pliku wejdź na stronę, odśwież ją, a następnie otwórz plik wp-content/debug.log – znajdziesz tam wpisy w formacie:

PHP Fatal error: [opis błędu] in /wp-content/plugins/[nazwa wtyczki]/plik.php on line 42

Mamy tu informację, na jakim pliku i w której konkretnie linijce zatrzymał się proces wykonywania kodu strony. To tam leży problem.

Jeżeli wpis w logach wskazuje na którąś z zainstalowanych wtyczek, wykonaj następujące kroki.

1. Wejdź do katalogu wp-content, a następnie do folderu plugins.
2. Znajdź podfolder wskazanej wtyczki i zmień jego nazwę na inną – wystarczy nawet dodać jedną literę, wtedy WP nie będzie mógł jej znaleźć i potraktuje ją tak, jakby była nieaktywna.
3. Odśwież stronę. Jeśli komunikat o błędzie krytycznym znikł, to znaczy, że za błędem PHP w WordPressie faktycznie stał wadliwy plugin.

Co, jeśli po wyłączeniu wtyczki strona nadal nie zadziała? Wtedy wróć do debug.log i sprawdź, jaki tym razem pojawia się błąd. Na stronach z dużą liczbą zainstalowanych pluginów czasem dochodzi do konfliktów między nimi. Być może trzeba sprawdzić kilka wtyczek.

Dalej opcje są trzy:

• jeśli dostępna jest aktualizacja pluginu – koniecznie ją zainstaluj, bo twórcy mogli już naprawić błąd;
• jeśli nie – możliwe, że będzie trzeba całkowicie usunąć wtyczkę i znaleźć dla niej alternatywę;
• jeżeli Twoja strona nie może normalnie funkcjonować bez tego konkretnego pluginu – warto skontaktować się z jego twórcami i przedstawić błąd wraz z logami.

Może również okazać się, że problem leży gdzieś indziej niż we wtyczkach, na przykład w pliku functions.php. To jeden z ważniejszych plików w całej instalacji WordPressa, bo pozwala dodawać niestandardowe funkcje PHP i zmieniać w ten sposób zachowanie witryny. Sęk w tym, że wystarczy jedna literówka, aby pojawił się błąd krytyczny.

Ważne jest to, że plik functions.php jest powiązany z motywem strony i uruchamia się razem z nim; dlatego jeśli chcesz sprawdzić, czy to on jest źródłem problemu, wystarczy, że zmienisz motyw.

1. Otwórz phpMyAdmin w panelu hostingu.
2. Przejdź do bazy danych swojej strony.
3. W tabeli wp_options znajdź dwa wpisy: template oraz stylesheet, a następnie zmień ich wartość na nazwę najnowszego domyślnego motywu WordPressa.
4. Odśwież stronę i sprawdź, czy błąd zniknął.

Jeśli masz dostęp przez SSH, możesz zrobić to samo (ale szybciej) przez WP-CLI przy użyciu komendy:

wp theme activate twentytwentyfive

Strona znów działa? To znaczy, że niemal na pewno trzeba przyjrzeć się bliżej functions.php – plik możesz pobrać przez FTP z folderu wp-content/themes/[nazwa motywu]. Przejrzyj go przede wszystkim pod kątem ostatnio wprowadzonych zmian – poszukaj literówek, brakujących średników, niezamkniętych nawiasów itp.

Jest jeszcze inna opcja. PHP, wykonując skrypty WordPressa, operuje w ramach określonego limitu pamięci RAM. Jeśli jakaś operacja go przekroczy, serwer także zatrzyma wykonywanie skryptu. W debug.log wygląda to tak:

PHP Fatal error: Allowed memory size of 134217728 bytes exhausted

134217728 bajtów to dokładnie 128 MB – na wielu hostingach współdzielonych tyle właśnie wynosi limit. Można go jednak zwiększyć:

• dodając w pliku wp-config.php linijkę:

define( 'WP_MEMORY_LIMIT', '256M' );

• edytując plik php.ini i zmieniając wartość linii (jeśli plik nie jest widoczny w katalogu głównym, należy szukać ustawień w panelu hostingu):

memory_limit = 128M;

• lub dodając do pliku .htaccess linię:

php_value memory_limit 256M

WordPress pozwala ustawić limit wyższy niż ten zdefiniowany w konfiguracji PHP tylko wtedy, gdy umożliwia to również hostingodawca. Jeżeli faktycznie Twoja witryna potrzebuje większej ilości pamięci RAM, być może trzeba będzie pomyśleć o migracji na serwer z bardziej elastyczną konfiguracją PHP? Z drugiej strony, dla większości serwisów 128 lub 256 MB powinno w zupełności wystarczyć, więc konieczność zwiększenia limitu RAM-u może świadczyć po prostu o słabej optymalizacji witryny.