Jak włączyć tryb debugowania WordPress, aby naprawić błędy

Jak włączyć tryb debugowania w WordPress lub uzyskać więcej informacji o błędach WordPress wyświetlanych w przeglądarce internetowej? Jeśli jesteś użytkownikiem lub programistą WordPressa i zadajesz te pytania, trafiłeś do odpowiedniego zasobu. W tym przewodniku dowiesz się, jak włączyć funkcje debugowania WordPress.

WordPress udostępnia kilka potężnych narzędzi do debugowania zarówno dla programistów, jak i nieprogramistów lub zwykłych użytkowników, które można włączyć, korzystając z dostępnych opcji konfiguracji. Po włączeniu tych opcji możesz szybko znaleźć i rozwiązać błędy, wyświetlając szczegółowe informacje o błędach.

Zademonstrujemy, wykorzystując następujący błąd, który napotkaliśmy podczas konfigurowania fikcyjnej witryny do celów testowych.

Kiedy spojrzysz na ten błąd, nie towarzyszy mu wiele informacji. Przyczyn może być wiele: serwer bazy danych może nie działać lub ustawienia połączenia z bazą danych (tj. nazwa bazy danych, użytkownik bazy danych i hasło użytkownika) zdefiniowane w pliku konfiguracyjnym wp-config.php mogą mylić się.

Jak zatem możemy uzyskać więcej informacji na temat powyższego błędu? Opcja WP_DEBUG to stała globalna zmienna PHP, która aktywuje tryb „debug” w całym WordPressie, powodując w ten sposób wyświetlenie w przeglądarce wszystkich błędów, powiadomień i ostrzeżeń PHP.

Ta funkcja „debug” została dodana w wersji WordPress 2.3.1 i jest skonfigurowana w wp-config.php – jednym z najważniejszych plików w instalacji WordPress.

Domyślnie funkcja „debug” jest ustawiona na false w dowolnej instalacji WordPress. Aby włączyć opcję WP_DEBUG, ustaw ją na true.

Najpierw przejdź do katalogu instalacyjnego swojej witryny, np. /var/www/html/mysite.com, a następnie otwórz plik wp-config.php za pomocą ulubionego edytora tekstu.

cd /var/www/html/mysite.com
sudo vim wp-config.php

Poszukaj tej linii.

define( 'WP_DEBUG',  false );

i zmień na

define( 'WP_DEBUG', true );

Zapisz plik i zamknij go.

Teraz został uruchomiony tryb debugowania. Jeśli ponownie załadujemy stronę, która pokazała błąd, zobaczymy szczegółowe informacje o błędzie, jak pokazano na poniższym zrzucie ekranu.

Istnieją dodatkowe opcje debugowania rozszerzające WP_DEBUG, które są szczególnie przydatne dla programistów WordPressa tworzących wtyczki, motywy lub inne komponenty. Są to WP_DEBUG_LOG i WP_DEBUG_DISPLAY.

Opcja WP_DEBUG_LOG ustawiona na true powoduje zapisywanie wszystkich błędów w pliku dziennika debug.log wewnątrz pliku /wp-content / domyślnie katalog. Jest to przydatne do późniejszej analizy lub przetwarzania.

define( 'WP_DEBUG_LOG', true );

Możesz jednak określić niestandardowy plik dziennika, np. /var/log/nginx/mysite.com_wp-errors.log:

define( 'WP_DEBUG_LOG', '/var/log/nginx/mysite.com_wp-errors.log' );

WP_DEBUG_DISPLAY kontroluje, czy komunikaty debugowania są wyświetlane w kodzie HTML stron, czy nie. Domyślnie jest ustawiona na true. Aby ją wyłączyć, ustaw ją na false.

define( 'WP_DEBUG_DISPLAY', false );

Włącz tryb debugowania w WordPress przy użyciu wtyczki

Jeśli korzystasz z hostingu współdzielonego, prawdopodobnie nie masz dostępu do zaplecza serwera, aby edytować pliki WordPress, w tym przypadku plik wp-config.php.

Lub jeśli po prostu wolisz zmieniać ustawienia z panelu administracyjnego, możesz zainstalować i używać wtyczki o nazwie „Pasek debugowania”, która pozwala łatwo włączyć/wyłączyć WP_DEBUG z panelu administracyjnego za pomocą jednego kliknięcia na Pasek narzędzi.

Zabójczą cechą tej wtyczki jest to, że jest bezpieczna i inteligentna, automatycznie wychodzi z trybu WP_DEBUG w przypadku błędów.

Odniesienie: Debugowanie w WordPress.