Jak włączyć tryb debugowania w WordPressie

Aktywacja trybu debugowania wymaga edycji jednego pliku w instalacji WordPressa. Jest to proste, ale należy zrobić to ostrożnie, aby nie uszkodzić strony. Poniżej znajdziesz instrukcję krok po kroku, jak zrobić to poprawnie.

Po włączeniu będziesz mógł rejestrować błędy, ukrywać je przed odwiedzającymi oraz kontrolować sposób, w jaki WordPress obsługuje informacje debugowe. Jest to szczególnie ważne na stronach produkcyjnych, gdzie błędy powinny być zapisywane, ale niepublicznie wyświetlane.

Lokalizowanie pliku wp-config.php

Pierwszym krokiem do włączenia trybu debugowania jest odnalezienie pliku wp-config.php. Plik ten znajduje się w katalogu głównym instalacji WordPressa, w tym samym miejscu co wp-content, wp-includes i wp-admin. Możesz się do niego dostać za pomocą programu FTP, menedżera plików w panelu hostingowym albo bezpośrednio, jeśli pracujesz na serwerze deweloperskim.

Zaleca się wykonanie kopii zapasowej tego pliku przed wprowadzeniem zmian. Brak jednego znaku może unieruchomić stronę, a kopia pozwoli ci natychmiast ją przywrócić. Po znalezieniu pliku otwórz go w edytorze tekstu i przygotuj się do modyfikacji konfiguracji.

Aktywacja WP_DEBUG

W pliku wp-config.php przewiń, aż znajdziesz linię podobną do tej: define( 'WP_DEBUG', false );. Ta linia kontroluje, czy tryb debugowania jest włączony. Domyślnie WordPress ma go wyłączonego ze względów bezpieczeństwa i wydajności. Aby go włączyć, wystarczy zmienić wartość z false na true.

Prawidłowa linia powinna wyglądać tak: define( 'WP_DEBUG', true );. Po zapisaniu pliku WordPress natychmiast zacznie wyświetlać ostrzeżenia, powiadomienia i błędy PHP na całej stronie. Dzięki temu możesz zidentyfikować problematyczne wtyczki, motywy lub własny kod.

Używanie WP_DEBUG_LOG do rejestrowania błędów

Wyświetlanie błędów na ekranie może być przydatne podczas tworzenia, ale nie zawsze jest praktyczne. Do monitorowania długoterminowego możesz włączyć WP_DEBUG_LOG. Aby to zrobić, dodaj poniższą linię zaraz pod stałą WP_DEBUG: define( 'WP_DEBUG_LOG', true );. Wszystkie błędy zostaną zapisane w pliku debug.log w katalogu wp-content.

Plik logów jest szczególnie pomocny, gdy musisz śledzić błędy pojawiające się w określonych momentach lub których nie możesz odtworzyć bezpośrednio na ekranie. Umożliwia też udostępnienie pliku deweloperom lub działom wsparcia bez dawania im dostępu do strony.

Ukrywanie błędów przed odwiedzającymi

Jeśli twoja strona WordPress działa na produkcji, prawdopodobnie nie chcesz, aby odwiedzający widzieli surowe komunikaty błędów. W takim przypadku możesz dodać kolejne ustawienie, które wyłączy ich wyświetlanie na froncie: define( 'WP_DEBUG_DISPLAY', false );. Dzięki temu błędy będą zapisywane, ale nie zostaną pokazane użytkownikom.

Dodatkowo możesz dodać @ini_set( 'display_errors', 0 );, aby wzmocnić to zachowanie. Takie rozwiązanie sprawia, że strona pozostaje profesjonalna i bezpieczna, a jednocześnie administratorzy i deweloperzy mają dostęp do niezbędnych informacji w logu.

Zaawansowane debugowanie z SCRIPT_DEBUG

Dla deweloperów pracujących z JavaScriptem i CSS WordPress oferuje dodatkową stałą: define( 'SCRIPT_DEBUG', true );. Domyślnie WordPress ładuje zminimalizowane wersje skryptów i stylów. Włączenie debugowania skryptów wymusza ładowanie pełnych, niezminimalizowanych wersji, które są łatwiejsze do analizy i debugowania.

To ustawienie jest szczególnie przydatne, jeśli tworzysz motywy lub wtyczki i musisz prześledzić zachowanie skryptów oraz stylów. Nie jest ono zazwyczaj potrzebne zwykłym użytkownikom, ale może być bardzo pomocne dla deweloperów rozwiązujących problemy na froncie.

Podsumowując, włączenie trybu debugowania w WordPressie to prosta, ale potężna metoda diagnozowania i utrzymywania strony. Edytując plik wp-config.php, możesz wyświetlać błędy, zapisywać je w logach i zachować profesjonalny wygląd witryny nawet podczas problemów. Odpowiednio używany tryb debugowania jest jednym z najważniejszych narzędzi do utrzymania WordPressa w bezpieczeństwie, stabilności i przyjazności dla deweloperów.