[Jak] Włączyć debugowanie WordPress, aby naprawić problemy (ponad 5 metod)

Wszystko, co musisz wiedzieć o włączaniu debugowania WordPress

Jeśli kiedykolwiek ci się to przydarzyło, wiesz, dlaczego musisz zrozumieć debugowanie WordPressa. Idziesz wypróbować najnowszą i najlepszą wtyczkę i jak tylko ją aktywujesz. Bum!

Twoja strona internetowa - martwa!

Chcesz odinstalować wtyczkę, ale nie możesz, ponieważ zaplecze również jest nieaktywne.

Albo jesteś Programista WordPress kodujesz nową wtyczkę, ale nie możesz zrozumieć, dlaczego nie działa tak, jak chcesz. Dlatego debugowanie jest niezbędną funkcją dla programistów i projektantów stron internetowych.

{automatycznie}

Czyż nie byłoby wspaniale, gdybyś mógł łatwo znaleźć błędy podczas pracy nad kodem, aby opracować nowy motyw lub wtyczkę? Debugowanie WordPressa to fajna funkcja, która pozwala łatwo znaleźć błędy i przestarzałe funkcje podczas wykonywania kodu w instalacji WP.

Jest to szczególnie przydatne w procesie debugowania, zwłaszcza jeśli próbujesz zaimplementować eksperymentalne funkcje w swoich motywach lub wtyczkach.

Domyślnie konfiguracja WordPressa ukrywa powiadomienia PHP podczas ładowania strony. Jeśli chcesz przeprowadzić debugowanie PHP i API WordPressa, musisz wykonać pewne zmiany, aby włączyć debugowanie WordPressa.

Wynika to z faktu, że większość witryn nie chce pokazywać błędów PHP na aktywnej stronie. Pokazywanie takich błędów debugowania WordPress może być niebezpieczne, ponieważ powiadomienia mogą ujawnić kluczowe szczegóły dotyczące Twojej witryny, kodu, ścieżek i innych informacji odwiedzającym Twoją witrynę, co może dać wskazówki hakerom. Informacje te mogą zostać wykorzystane do wykorzystania i użycia złośliwych kodów w celu naruszenia Twojej witryny.

Spis zalecanych lektur: 17 działań zapobiegających zwiększeniu bezpieczeństwa WordPress

W fazie rozwoju, Kodeks WP zdecydowanie zaleca programistom włączenie debugowania WordPressa.

W rzeczywistości włączenie debugowania WordPressa pomoże Ci na dwa sposoby.

• Błędy PHP:Pokazuje błędy spowodowane przez dowolne funkcje PHP
• Przestarzałe funkcje: Są to funkcje, które mogły być używane w poprzednich wersjach kodu, ale niedawno zostały oznaczone jako nie do użycia. Pomoże Ci to znaleźć funkcję zastępczą do użycia.

W tym poście przyjrzymy się różnym stałym debugowania WordPressa i sposobowi włączania rejestrowania błędów w instalacji lub witrynie…

Ustawienia debugowania WordPress

1. Włącz debugowanie WordPess za pomocą WP_DEBUG

Najważniejszą stałą PHP, której można użyć do włączenia trybu debugowania na swojej stronie, jest WP_DEBUG.

Domyślnie ta stała PHP jest ustawiona na false. Będzie ona wyświetlana w następujący sposób w Twoim wp-config.php plik. 

define( 'WP_DEBUG', false );

Aby włączyć rejestrowanie, wystarczy ustawić opcję WP_DEBUG na true.

Zobacz kod poniżej.

define( 'WP_DEBUG', true );

Poniżej znajduje się kilka rzeczy, które musisz mieć na uwadze przed włączeniem debugowania WordPressa.

• Zachowaj ostrożność przed wprowadzeniem jakichkolwiek zmian w swoim wp-config.php plik, ponieważ jest to najważniejszy plik w instalacji, który można wykorzystać do skonfigurowania dostępu do bazy danych, zwiększenia wydajności i poprawy bezpieczeństwa. Popełnienie małego błędu w konfiguracji może spowodować, że Twoja witryna stanie się niedostępna
• Upewnij się, że nie włączasz debugowania WordPress na aktywnej stronie. Jak już powiedzieliśmy, kluczowe informacje mogą zostać ujawnione, poza faktem, że pozostawienie włączonego debugowania WordPress spowoduje problemy z wydajnością, ponieważ skutkuje to znacznym obciążeniem

Polecam czytanie: Jak wykonać kopię zapasową WordPressa natywnie lub za pomocą wtyczki

Teraz, gdy włączyliśmy ustawienie debugowania WordPressa, musimy przyjrzeć się wynikom poleceń debugowania. Aby to zrobić, najlepiej włączyć plik dziennika debugowania WordPressa.

Można to zrobić, włączając następne ustawienie w wp-config.php.

2. Rejestruj błędy w debug.log za pomocą WP_DEBUG_LOG

Aby móc przejrzeć wszelkie błędy debugowania WordPress, powiadomienia lub inne dane wyjściowe, musimy przejrzeć plik debugowania WordPress. Być może będziesz musiał wysłać ten plik do dostawców lub programistów WordPress, z którymi współpracujesz.

Aby wygenerować plik dziennika debugowania WordPress, musisz włączyć „Rejestrowanie debugowania WordPress” za pomocą ustawienia WP_DEBUG_LOG. Ta stała zasadniczo wymusza na WordPressie zapisywanie wyników debugowania do pliku dziennika.

Ta stała PHP zapisuje wszystkie powiadomienia o błędach w pliku debug.log plik znajdujący się w katalogu 'wp-content', dzięki czemu będziesz mógł przejrzeć takie powiadomienia/błędy w dowolnym momencie.

Należy pamiętać, że ustawienie WP_DEBUG_LOG działa w powiązaniu ze stałą WP_DEBUG, tzn. WP_DEBUG musi być włączone, aby ustawienie WP_DEBUG_LOG zaczęło obowiązywać.

Oto jak włączyć rejestrowanie debugowania w debug.log plik. Po prostu dodaj następujący kod do swojego wp-config.php plik.

define( 'WP_DEBUG_LOG', true);

Po ustawieniu tej opcji na wartość true wszystkie błędy motywów i wtyczek będą śledzone i zapisywane w debug.log plik.

Istnieje również możliwość ustawienia innego pliku za pomocą małej wariacji w tym ustawieniu. Na przykład, jeśli chcesz ustawić inną lokalizację lub nazwę dla pliku dziennika, możesz użyć następującego:

zdefiniuj( 'WP_DEBUG_LOG', '/logs/wordpress-errors.log' );

Powyższe ustawienia nie mają wpływu na to, co jest wyświetlane na frontendzie. Można to ustawić niezależnie, korzystając z następnego ustawienia, które omówimy poniżej.

3. Włącz/wyłącz wyświetlanie błędów za pomocą WP_DEBUG_DISPLAY

Spójrz na poniższy zrzut ekranu. Tak mogłaby wyglądać Twoja strona internetowa, gdyby WP_DEBUG_DISPLAY było włączone. Zasadniczo jest to ustawienie, które zmusza WordPressa do wyświetlania błędów na front-endzie, zamiast po prostu zapisywania ich do pliku dziennika, jak widzieliśmy w poprzednich krokach.

W większości przypadków wystarczy, że włączysz WP_DEBUG_LOG, aby śledzić wszelkie błędy powodowane przez Twoje motywy i wtyczki w pliku dziennika.

Jeśli jednak pracujesz w środowisku programistycznym, możesz także zdecydować się na wyświetlanie powiadomień i błędów PHP na stronie front-end. 

Stała WP_DEBUG_DISPLAY w pliku wp-config.php umożliwia włączenie/wyłączenie wyświetlania komunikatów debugowania w interfejsie użytkownika witryny.

Domyślnie, jeśli włączono debugowanie WordPress, wyświetlanie komunikatów o błędach WordPress jest ustawione na 'true'. Możesz zmienić na 'false', jeśli chcesz je ukryć.

Wszystko, co musisz zrobić, to dodać poniższy wiersz kodu do pliku wp-config.php.

define( 'WP_DEBUG_DISPLAY', false);

Zachowaj ostrożność, jeśli włączysz tę opcję na aktywnej stronie, ponieważ może to ujawnić poufne informacje. Jeśli włączysz ją tymczasowo, nie zapomnij wyłączyć jej po zidentyfikowaniu i rozwiązaniu problemu.

4. Włącz debugowanie skryptu za pomocą SCRIPT_DEBUG  

Do tej pory omawialiśmy znaczenie trybu WP_DEBUG i jak go włączyć w instalacji witryny. Istnieje inna ważna stała PHP, którą możesz włączyć do debugowania skryptów WordPress: SCRIPT_DEBUG.

Podczas gdy włączenie opcji WP_DEBUG ujawnia wszelkie błędy spowodowane przez funkcje PHP w motywie WordPress i wtyczkach, włączenie opcji SCRIPT_DEBUG pokazuje, czy występują jakieś błędy Rozwój JavaScript lub błędy CSS.

W rzeczywistości podczas debugowania, jeśli stała SCRIPT_DEBUG jest włączona, wymusza ona na WordPressie korzystanie z wersji rozwojowej plików zamiast ich zminimalizowanej wersji.

Jak być może wiesz, WordPress ładuje zminimalizowane wersje plików CSS i JS w środowisku rzeczywistym. Te zminimalizowane wersje plików usuwają wszystkie niepotrzebne znaki w tych plikach w celu zmniejszenia rozmiaru pliku, aby przyspieszyć ładowanie strony.

Polecam lekturę: 21 działań, które przyspieszą działanie WordPressa

Ładowanie zminimalizowanych plików może być niezwykle pomocne pod względem doświadczenia użytkownika i WordPress SEO, może to być uciążliwe dla celów programistycznych, szczególnie gdy trzeba znaleźć i naprawić błędy.

Wymuszając załadowanie wersji rozwojowej przez instalację, możesz łatwo dowiedzieć się, które skrypty powodują konflikty w Twoich podstawowych plikach CSS i JS. Użycie tego ustawienia w połączeniu z konsolą narzędzi przeglądarki pozwala zidentyfikować, gdzie są zgłaszane błędy JavaScript, dzięki czemu możesz je naprawić.

Aby włączyć SCRIPT_DEBUG, dodaj poniższy kod do pliku wp-config.php.

define( 'SCRIPT_DEBUG', true );

5. Włączanie/wyłączanie rejestrowania zapytań do bazy danych

Ponownie, podczas debugowania problemów, możesz chcieć zwrócić uwagę na to, które zapytania do bazy danych są uruchomione. W szczególności, jeśli rozwiązujesz problemy i problemy z wydajnością, możesz chcieć sprawdzić dokładnie, które zapytania są uruchomione.

wp-config.php plik ma inne ustawienie, które pozwala na logowanie wszystkich uruchomionych zapytań. Dodaj następujący wiersz do w-config, aby włączyć zapisywanie zapytań. 

zdefiniuj('SAVEQUERIES', true);

Po włączeniu tej opcji wszystkie zapytania zostaną zapisane w $wpdb->zapytania global. Jeśli nie jesteś pewien, jaka jest wartość zmiennej, możesz dodać następujący fragment kodu PHP do pliku w WordPressie. Spowoduje to wyświetlenie wartości $wpdb->zapytania zmienna globalna.

zapytania ); ?>

Wtyczki debugowania WordPress

Oprócz komunikatów o błędach dziennika, możesz również potrzebować sprawdzić wydajność zapytań lub spróbować zrozumieć, co dzieje się pod maską. Istnieje szereg innych wtyczek i narzędzi, których zalecamy używać, gdy musisz wykonać takie debugowanie lub rozwiązywanie problemów. 

1. Monitor zapytań

Monitor zapytań to fajna wtyczka, która pozwala zobaczyć dokładnie, co robią różne wtyczki w instalacji WordPressa. Mimo że nazwa mówi, że jest to „monitor zapytań”, ta wtyczka robi więcej niż tylko monitorowanie zapytań do bazy danych.

W rzeczywistości ta wtyczka może:

• debugowanie zapytań
• monitoruj błędy PHP
• sprawdź haki i akcje
• Wywołania API HTTP
• monitoruj kolejkowane skrypty i arkusze stylów 
• debugowanie wywołań AJAX
• itd.

Można również zawęzić zakres monitorowania według wtyczki lub motywu, co pozwala na precyzyjne wykrycie źródeł problemów.

2. Pasek debugowania

wtyczka jest zazwyczaj używany przez deweloperów podczas kodowania ich motywów lub wtyczek. Wtyczka dodaje menu debugowania do paska administracyjnego WordPress, które pokazuje zapytania, pamięć podręczną i inne informacje debugowania WordPress. 

Najważniejsze jest to, że respektuje ustawienia debugowania WordPressa, które opisaliśmy powyżej.

3. Rejestruj powiadomienia o wycofaniu

To jest inny wtyczka przeznaczona dla programistów. Zasadniczo rejestruje, czy używasz jakichkolwiek przestarzałych funkcji, plików lub argumentów, dzięki czemu możesz uaktualnić i naprawić swój kod, aby użyć najnowszych zaleceń.

Zapisywanie do dziennika debugowania WordPress

Jako programista powinieneś prawdopodobnie dodać informacje o błędach do dziennika debugowania WordPressa, jeśli to konieczne. Aby to zrobić, musisz użyć określonej funkcji WordPressa, która wyprowadza wiadomości do dziennika:

error_log( "This is a log entry" );

Jeśli debugowanie jest włączone, powyższa wiadomość pojawi się w pliku dziennika. Możesz użyć powyższego, aby rejestrować wyjątki lub inne nieoczekiwane problemy.

Często zadawane pytania dotyczące debugowania WordPress

Do czego służy debugowanie WordPressa?

Różne ustawienia debugowania WordPress umożliwiają przeglądanie wszelkich powiadomień, takich jak błędy, wycofane funkcje lub wszelkie inne dzienniki błędów generowane przez motywy, wtyczki i inne funkcje WordPress. Włączając powyższe ustawienia, możesz zidentyfikować i naprawić wszelkie błędy w swoich wtyczkach lub motywach WordPress.

Gdzie znajduje się dziennik debugowania WordPressa?

Dziennik debugowania WordPressa zwykle znajduje się w katalogu głównym pod nazwą debug.log. Używając ustawień zdefiniowanych powyżej, możesz zmienić lokalizację dziennika debugowania WordPressa na lokalizację, która jest dla Ciebie wygodniejsza.

Jak wyłączyć debugowanie w WordPressie?

Aby wyłączyć debugowanie w WordPressie, wystarczy dodać następujący wpis do pliku wp-config.php: define( 'WP_DEBUG', false ); Warto również sprawdzić pozostałe ustawienia, które opisujemy w tym artykule.

Co robi WP Debug?

Ustawienie WP Debug w pliku wp-config.php służy do włączania lub wyłączania debugowania WordPressa.

Czy debugowanie WordPressa wpływa na wydajność?

Tak, debugowanie WordPressa ma wpływ na wydajność, ponieważ dodaje pewne obciążenie, w tym konieczność wyprowadzania do pliku. Zaleca się, aby po zakończeniu debugowania wyłączyć wszystkie takie ustawienia. Dzięki temu instalacja jest również bezpieczniejsza, ponieważ poufne informacje mogą być zawarte w dziennikach debugowania.

Podsumowanie

Jeśli chcesz szybko podsumować wszystko, co omówiliśmy, spójrz na poniższy przykładowy plik wp-config.php ze wszystkimi ustawieniami: 

// Włącz tryb WP_DEBUG — aby go wyłączyć, wystarczy wpisać false zamiast true define( 'WP_DEBUG', true ); // Włącz rejestrowanie debugowania w pliku /wp-content/debug.log define( 'WP_DEBUG_LOG', true );
// Skomentuj powyższy plik i usuń komentarz z poniższego, aby zalogować się do określonego pliku
//define( 'WP_DEBUG_LOG', '/logs/wordpress-errors.log' ); // Wyłącz wyświetlanie błędów i ostrzeżeń / przełącz na true, aby włączyć define( 'WP_DEBUG_DISPLAY', false ); // Użyj wersji deweloperskich podstawowych plików JS i CSS (potrzebne tylko w przypadku modyfikacji tych podstawowych plików) define( 'SCRIPT_DEBUG', true );

// Włączono zapytania dziennika, przełącz na fałsz, aby wyłączyć
zdefiniuj('SAVEQUERIES', true);

Czy kiedykolwiek włączyłeś debugowanie WordPressa? Podziel się z nami swoimi przemyśleniami w sekcji komentarzy…