Proces debugowania w WordPressie stanowi standardową praktykę, którą warto wykonywać regularnie w celu wykrywania i eliminowania błędów, zanim staną się poważniejszym problemem. Choć procedura ta może wymagać większej znajomości systemu, odpowiednie instrukcje mogą ułatwić jej przeprowadzenie, zwłaszcza osobom, które nie miały wcześniej z nią styczności. Działanie WordPressa opiera się na języku PHP, a nawet niewielkie błędy w jego kodzie mogą prowadzić do nieprawidłowego wyświetlania strony. Włączenie trybu debugowania umożliwia szybkie znalezienie i rozwiązanie problemu, zanim wpłynie on na doświadczenie użytkowników. Domyślnie funkcja WP Debug pozostaje wyłączona, dlatego konieczne jest jej ręczne aktywowanie na czas analizy i wyłączenie po zakończeniu prac w celu zachowania bezpieczeństwa witryny.

Przeczytaj także:

Spis treści

Co to jest debugowanie?

Proces debugowania w WordPressie warto rozpocząć od zrozumienia samego pojęcia „debugowanie”. Termin ten odnosi się do identyfikowania, naprawiania oraz poprawiania błędów w kodzie, które mogą wpływać na działanie strony. W języku programistycznym „bug” oznacza błąd, a debugowanie to jego eliminacja w celu przywrócenia poprawnego funkcjonowania systemu. W tym celu wykorzystuje się specjalne narzędzia, nazywane debuggerami, które umożliwiają wykrywanie i usuwanie nieprawidłowości w kodzie, zapewniając stabilność działania witryny.

Na czym polega tryb debugowania WordPress?

Tryb debugowania w WordPressie pozwala na wykrywanie błędów w kodzie strony opartej na tym popularnym systemie zarządzania treścią. Można go skonfigurować tak, aby błędy były jedynie zapisywane lub od razu wyświetlane, w zależności od potrzeb. Istnieje również możliwość jednoczesnego korzystania z obu tych opcji.

Rozwiązanie to jest szczególnie przydatne dla osób zaznajomionych z kodowaniem i językiem PHP, ponieważ wskazuje problemy w skrypcie, które mogą zostać szybko zidentyfikowane i poprawione. Regularne korzystanie z tego trybu pozwala na optymalizację działania strony oraz zapobieganie potencjalnym problemom. Warto uruchamiać go zwłaszcza po każdej zmianie w kodzie, aby upewnić się, że modyfikacje zostały wprowadzone prawidłowo i nie powodują nieoczekiwanych błędów.

Tryb debugowania w WordPress – w jakim celu się go stosuje?

Tryb debugowania w WordPressie dotyczy wyłącznie stron opartych na tym systemie i służy do wykrywania błędów w kodzie witryny. Pozwala na identyfikację problemów związanych z błędną składnią, brakującymi znakami, nieprawidłowymi poleceniami czy próbami wywołania niewłaściwych zmiennych.

Strony działające na WordPressie opierają się nie tylko na PHP, ale także na innych technologiach. Struktura frontendowa wykorzystuje HTML i CSS, backend opiera się na PHP i bazach danych, a dodatkowe funkcjonalności zapewniają wtyczki tworzone przez zewnętrznych deweloperów. Ze względu na złożoność systemu, ręczne odnalezienie przyczyny błędu może być skomplikowane. Tryb debugowania pozwala na przeglądanie oraz rejestrowanie problemów wraz ze szczegółowym opisem, co znacznie ułatwia ich szybkie wykrycie i naprawę.

Jak włączyć tryb debugowania w WordPress?

Aktywacja trybu debugowania w WordPressie wiąże się z koniecznością edycji pliku wp-config.php. Aby uniknąć utraty danych w przypadku nieoczekiwanych problemów, zaleca się wcześniejsze wykonanie kopii zapasowej tego pliku. Dzięki temu, w razie potrzeby, możliwe będzie szybkie przywrócenie strony do wcześniejszego stanu i uniknięcie ewentualnych komplikacji wynikających z nieprawidłowych zmian w kodzie.

Edycja wp-config.php

Po utworzeniu kopii zapasowej można przystąpić do włączenia trybu debugowania. W tym celu należy otworzyć plik wp-config.php, który znajduje się w głównym katalogu WordPressa. Można to zrobić poprzez panel administracyjny hostingu lub korzystając z klienta FTP/SFTP, takiego jak FileZilla czy WinSCP, aby pobrać plik na dysk komputera.

Po otwarciu pliku w edytorze tekstowym, zaraz po linijce <?php, należy dodać następujący fragment kodu:

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

Pierwsza z tych opcji umożliwia aktywację trybu debugowania, druga odpowiada za wyświetlanie błędów bezpośrednio na stronie, a trzecia zapisuje je w pliku logów. Nie wszystkie te funkcje muszą być aktywowane jednocześnie. Ze względów bezpieczeństwa oraz reputacji strony zaleca się, aby opcja wyświetlania błędów w przeglądarce pozostawała wyłączona, ponieważ może ujawnić wrażliwe informacje wszystkim odwiedzającym witrynę.

Każdą z tych funkcji można łatwo wyłączyć, zmieniając wartość true na false. Dzięki temu błędy będą rejestrowane w pliku logów, ale nie będą widoczne publicznie, co zapewni większą kontrolę nad działaniem witryny bez ryzyka ujawnienia problemów użytkownikom.

Co to jest logowanie błędów PHP w debug.log?

Jeśli obie opcje debugowania zostały aktywowane, przeglądanie błędów jest możliwe bezpośrednio po zalogowaniu do WordPressa. Po otwarciu strony powiadomienia o błędach powinny pojawić się na ekranie.

Dodatkowe informacje można znaleźć w pliku zapisu błędów, który domyślnie nosi nazwę debug.log i jest przechowywany w katalogu wp-content na serwerze. Aby uzyskać do niego dostęp, wystarczy skorzystać z klienta FTP, takiego jak FileZilla, i pobrać plik na swój komputer. Można go otworzyć w dowolnym edytorze tekstowym, np. w Notatniku, gdzie znajdują się szczegółowe dane dotyczące wszystkich zarejestrowanych zdarzeń.

Jak edytować plik php.ini?

Aby włączyć rejestrowanie błędów PHP, konieczna jest edycja pliku php.ini. Należy pobrać go na komputer, otworzyć w edytorze tekstowym i dodać następujący kod:

display_startup_errors = Off  
display_errors = Off  
error_reporting = E_ALL  
log_errors = On  
error_log = /przykladowa/ścieżka/pliku/bledy.log

Szczególną uwagę należy zwrócić na ostatnią linijkę, w której należy zastąpić przykładową ścieżkę rzeczywistą lokalizacją pliku przeznaczonego do rejestracji błędów.

W pliku dziennika każda odnotowana sytuacja zapisywana jest w określonym formacie, który zawiera cztery podstawowe informacje. Pierwszym elementem jest data i godzina wystąpienia błędu, np. [21-Mar-2022 19:11:32 UTC]. Następnie podawany jest typ błędu, np. Błąd krytyczny PHP. Kolejna część to opis przyczyny, np. Uncaught Error: Call to undefined function writeMsg() in, a na końcu znajduje się ścieżka do pliku, w którym wystąpił problem.

Dzięki tak szczegółowym informacjom możliwe jest szybkie odnalezienie przyczyny błędu i jego usunięcie, co pozwala na sprawniejsze zarządzanie działaniem strony.

Wyłączanie trybu debugowania WordPressa

Regularne korzystanie z trybu debugowania w WordPressie jest zalecane, szczególnie w kontekście zapisywania błędów w plikach logów. Warto jednak uruchamiać tę funkcję jedynie podczas optymalizacji strony, a po zakończeniu prac dezaktywować ją ze względów bezpieczeństwa. Usuwanie zapisanych dzienników błędów również jest istotne, ponieważ w przypadku nieautoryzowanego dostępu mogą one zostać wykorzystane w sposób niepożądany.

Wyłączenie trybu debugowania jest szybkie i prostsze niż jego aktywacja. Wystarczy ponownie pobrać plik wp-config.php i edytować jego zawartość. Można to zrobić na dwa sposoby: całkowicie usuwając dodany wcześniej kod odpowiedzialny za debugowanie lub zmieniając jego wartości na wyłączone. W drugim przypadku należy zastąpić true wartością false, co sprawi, że funkcja przestanie działać. Ostateczna wersja kodu powinna wyglądać następująco:

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

Po wprowadzeniu zmian należy zapisać plik i ponownie przesłać go na serwer za pomocą klienta FTP. Po tej operacji WordPress przestanie zarówno wyświetlać, jak i rejestrować błędy, co pozwoli na zachowanie większego bezpieczeństwa i stabilności strony.

Tryb debugowania WordPress – co to jest i jak włączyć?