[Jak to zrobić] Włącz debugowanie WordPress, aby rozwiązać problemy (metody 5+)

Debugowanie WordPress

… Wszystko, co musisz wiedzieć o włączaniu debugowania WordPressa.

Jeśli zdarzyło Ci się to kiedykolwiek, wiesz, dlaczego potrzebujesz debugowania WordPress: Idź wypróbować najnowszą i najlepszą wtyczkę, jak tylko ją aktywujesz. Bum!

Twoja strona internetowa - Martwa!

Chcesz odinstalować wtyczkę, ale nie możesz, ponieważ backend też jest martwy.

Albo jesteś Programista WordPress kodowanie nowej wtyczki, 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.

Czy nie byłoby wspaniale, gdybyś mógł łatwo znaleźć błędy podczas pracy nad kodem do tworzenia nowego motywu lub wtyczki? Debugowanie WordPress 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 podczas procesu debugowania, zwłaszcza jeśli próbowałeś zaimplementować eksperymentalne funkcje w swoich motywach lub wtyczkach.

Domyślnie konfiguracja WordPress ukrywa powiadomienia PHP podczas ładowania strony. Jeśli chcesz przeprowadzić debugowanie PHP i interfejsu API WordPress, musisz wprowadzić kilka poprawek, aby włączyć debugowanie WordPress.

Wynika to z faktu, że większość stron internetowych nie chce pokazywać błędów PHP na działającej stronie. Pokazywanie takich błędów debugowania WordPressa 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ą następnie zostać wykorzystane do wykorzystania i wykorzystania złośliwych kodów w celu naruszenia 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 WordPress.

W rzeczywistości włączenie debugowania WordPressa pomoże Ci na 2 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 zostały ostatnio oznaczone jako nieużywane. Pomoże Ci to znaleźć funkcję zastępczą do użycia.

W tym poście rzućmy okiem na różne stałe debugowania WordPressa i jak włączyć rejestrowanie błędów w Twojej instalacji lub witrynie…

Ustawienia debugowania WordPress

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

debugowanie wp

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

Domyślnie ta stała PHP ma wartość false. Zostanie to pokazane w następujący sposób w twoim wp-config.php plik. 

define( 'WP_DEBUG', false );

Aby włączyć logowanie, wystarczy ustawić WP_DEBUG na true.

Zobacz kod poniżej.

define( 'WP_DEBUG', true );

Poniżej znajduje się kilka rzeczy, o których musisz pamiętać 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órego można użyć do skonfigurowania dostępu do bazy danych, zwiększenia wydajności i poprawy bezpieczeństwa. Mały błąd w konfiguracji może spowodować, że Twoja witryna stanie się niedostępna
  • Upewnij się, że nie włączasz debugowania WordPress w działającej witrynie. Jak powiedzieliśmy wcześniej, kluczowe informacje mogą zostać ujawnione, poza tym, że pozostawienie włączonego debugowania WordPressa spowoduje problemy z wydajnością, ponieważ spowoduje znaczne obciążenie

Polecam czytanie: Jak wykonać kopię zapasową WordPress 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 WordPress.

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

2. Loguj błędy do debug.log za pomocą WP_DEBUG_LOG

Aby móc przejrzeć wszelkie błędy debugowania WordPress, powiadomienia lub inne dane wyjściowe, musimy zajrzeć do pliku debugowania WordPress. Prawdopodobnie będziesz musiał wysłać ten plik do dowolnych 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 zmusza WordPress do zapisywania danych wyjściowych debugowania do pliku dziennika.

To, co robi ta stała PHP, to zapisuje wszystkie powiadomienia o błędach w a debug.log plik znajdujący się w ustawieniach katalogu „wp-content”, dzięki czemu możesz przeglądać takie powiadomienia/błędy w dowolnym momencie.

DZIENNIK DEBUGOWANIA WP
Zauważ, że ustawienie WP_DEBUG_LOG działa w połączeniu ze stałą WP_DEBUG, tj. WP_DEBUG musi być włączone, aby ustawienie WP_DEBUG_LOG zaczęło obowiązywać.

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

define( 'WP_DEBUG_LOG', true);

Po ustawieniu na 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ą niewielkiej odmiany tego ustawienia. Na przykład, jeśli chcesz ustawić inną lokalizację lub nazwę pliku dziennika, możesz użyć następującego:

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


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

3. Włącz / wyłącz błędy wyświetlania za pomocą WP_DEBUG_DISPLAY

Spójrz na poniższy zrzut ekranu. Tak może wyglądać Twoja witryna, jeśli WP_DEBUG_DISPLAY jest włączony. Zasadniczo jest to ustawienie, które zmusza WordPressa do wyświetlania błędów na interfejsie użytkownika, zamiast po prostu zapisywać je w pliku dziennika, jak widzieliśmy w poprzednich krokach.

wyświetlanie WP DEBUG

W większości przypadków, jeśli włączyłeś WP_DEBUG_LOG, aby śledzić wszelkie błędy spowodowane przez twoje motywy i wtyczki do pliku dziennika.

Jeśli jednak pracujesz w środowisku programistycznym, możesz również wybrać wyświetlanie powiadomień lub błędów PHP również na interfejsie witryny. 

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

Domyślnie, jeśli włączyłeś debugowanie WordPress, wyświetlanie komunikatów o błędach WordPress jest ustawione na „prawda”. Możesz zmienić to na „fałsz”, 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 to w działającej witrynie, ponieważ może to ujawnić poufne informacje. Jeśli włączysz go tymczasowo, nie zapomnij wyłączyć po zidentyfikowaniu i naprawieniu problemu.

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

Debugowanie skryptu WP

Do tej pory omówiliśmy znaczenie trybu WP_DEBUG i sposób włączenia go w instalacji witryny. Jest jeszcze jedna ważna stała PHP, którą możesz włączyć do debugowania skryptów WordPress: SCRIPT_DEBUG.

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

W rzeczywistości, podczas debugowania, jeśli stała SCRIPT_DEBUG jest włączona, zmusza WordPressa do używania rozwojowej wersji plików zamiast wersji zminifikowanej.

Jak być może wiesz, WordPress ładuje zminimalizowane wersje plików CSS i JS w środowisku na żywo. Te zminimalizowane wersje plików usuwają wszystkie niepotrzebne znaki z tych plików, starając się zmniejszyć rozmiar pliku w celu szybszego ładowania strony.

Polecam lekturę21 działań, aby przyspieszyć WordPress

Podczas ładowania zminifikowanych 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, zwłaszcza gdy próbujesz znaleźć i naprawić błędy.

Wymuszając instalację w celu załadowania wersji rozwojowej, możesz łatwo dowiedzieć się, jakie skrypty powodują konflikty w podstawowych plikach CSS i JS. Korzystanie z tego ustawienia w połączeniu z konsolą narzędzi przeglądarki pozwala określić, gdzie są zgłaszane błędy JavaScript, aby można je było naprawić.

Aby włączyć SCRIPT_DEBUG, dodaj następujący kod do pliku wp-config.php.

define( 'SCRIPT_DEBUG', true );

5. Włącz/wyłącz rejestrowanie zapytań do bazy danych

Jeszcze raz, podczas debugowania problemów, warto 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ć dokładnie sprawdzić, które zapytania są uruchomione.

Pandemia wp-config.php plik ma inne ustawienie, które pozwala na rejestrowanie wszystkich uruchamianych zapytań. Dodaj następujący wiersz do w-config, aby umożliwić zapisywanie zapytań. 

define('SAVEQUERIES', prawda);

Po włączeniu tej opcji wszystkie zapytania będą zapisywane w $wpdb->zapytania światowy. Jeśli nie masz pewności, jaka jest wartość zmiennej, możesz dodać następujący skrypt fragmentu kodu PHP do pliku w WordPress. Spowoduje to wyświetlenie wartości $wpdb->zapytania zmienna globalna.

zapytania ); ?>

 

Wtyczki debugowania

Oprócz komunikatów o błędach dziennika, może być również konieczne sprawdzenie zapytań pod kątem wydajności lub w inny sposób spróbuj zrozumieć, co dzieje się pod maską. Istnieje wiele innych wtyczek i narzędzi, których zalecamy używać, gdy musisz przeprowadzić takie debugowanie lub rozwiązywanie problemów. 

1. Monitor zapytań

Monitor zapytań to zgrabna wtyczka, która pozwala dokładnie zobaczyć, co robią różne wtyczki w Twojej instalacji WordPress. Mimo że nazwa mówi, że jest to „monitor zapytań”, wtyczka ta nie tylko monitoruje zapytania do bazy danych.

zrzut ekranu monitora zapytania

W rzeczywistości ta wtyczka może:

  • debuguj zapytania
  • monitoruj błędy PHP
  • sprawdź hooki i akcje
  • Wywołania HTTP API
  • monitorować w kolejce skrypty i arkusze stylów 
  • debugowanie wywołań AJAX
  • itd.

Możesz także zawęzić takie monitorowanie według wtyczki lub motywu, co pomaga zawęzić źródła problemów.

2. Pasek debugowania

wtyczka jest zwykle używany przez programistów, którzy kodują swoje motywy lub wtyczki. Wtyczka dodaje menu debugowania do paska administracyjnego WordPress, które pokazuje zapytania, pamięć podręczną i inne informacje dotyczące debugowania WordPress. 

Wspaniałą rzeczą jest to, że respektuje ustawienia debugowania WordPressa, które opisaliśmy powyżej.

3. Rejestruj przestarzałe powiadomienia

To jest inny wtyczka zorientowana na programistę. Zasadniczo rejestruje, czy używasz przestarzałych funkcji, plików lub argumentów, dzięki czemu możesz uaktualnić i naprawić kod, aby korzystać z najnowszych zaleceń.

Zapisywanie w dzienniku debugowania WordPress

Jako programista prawdopodobnie powinieneś w razie potrzeby dodać informacje o błędach do dziennika debugowania WordPressa. Aby to zrobić, musisz użyć określonej funkcji WordPress, która wyprowadza komunikaty do dziennika:

error_log( "This is a log entry" );

Jeśli debugowanie jest włączone, powyższy komunikat pojawi się w pliku dziennika. Możesz użyć powyższego do rejestrowania wyjątków lub innych nieoczekiwanych problemów.

Często zadawane pytania

Co robi debugowanie WordPressa?

Różne ustawienia debugowania WordPressa umożliwiają przeglądanie wszelkich powiadomień, takich jak błędy, przestarzałe 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 we wtyczkach lub motywach WordPress.

Gdzie jest dziennik debugowania WordPressa?

Dziennik debugowania WordPressa zwykle znajduje się w katalogu głównym pod nazwą debug.log. Korzystając z powyższych ustawień, możesz zmienić lokalizację dziennika debugowania WordPress na wygodniejszą dla Ciebie.

Jak wyłączyć debugowanie w WordPressie?

Aby wyłączyć debugowanie w WordPressie, po prostu dodaj następujący wpis do pliku wp-config.php: define( 'WP_DEBUG', false ); Możesz także sprawdzić pozostałe ustawienia opisane w tym artykule.

Co robi debugowanie WP?

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

Czy debugowanie WordPressa wpływa na wydajność?

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

Podsumowanie

Jeśli chcesz krótkie podsumowanie wszystkiego, co omówiliśmy, spójrz na poniższy przykładowy plik wp-config.php ze wszystkimi ustawieniami na miejscu: 

// Włącz tryb WP_DEBUG - aby wyłączyć, po prostu wpisz false zamiast true define( 'WP_DEBUG', true ); // Włącz rejestrowanie debugowania do pliku /wp-content/debug.log define( 'WP_DEBUG_LOG', true );
// Skomentuj powyższy plik i odkomentuj poniższy, aby zalogować się do określonego pliku
//definiuj( '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 wtedy, gdy modyfikujesz te podstawowe pliki) define( 'SCRIPT_DEBUG', true );

// Logowanie zapytań włączone, przełącz na false, aby wyłączyć
define('SAVEQUERIES', prawda);

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

Pobierz listę 101 trików WordPress, które każdy bloger powinien znać

101 sztuczek WordPress

Kliknij tutaj, aby pobrać teraz
 

Potrzebujesz pomocy w załatwieniu spraw? Wypróbuj te najwyżej oceniane niedrogie koncerty na Fiverr!

logo piątki

Kliknij tutaj znaleźć ekspertów na temat naprawianie problemów z WordPressem.

Kliknij tutaj stworzyć pełna strona WordPress.

O autorze
Shahzad Saeed
Autor: Shahzad SaeedStrona internetowa: http://shahzadsaeed.com/
Shahzaad Saaed był opisywany w wielu witrynach autorytetów jako ekspert od WordPressa. Specjalizuje się w content marketingu, aby pomóc biznesowi zwiększyć ruch.

Jeszcze jedna rzecz... Czy wiesz, że osoby, które udostępniają przydatne rzeczy, takie jak ten post, również wyglądają NIESAMOWITE? ;-)
Proszę zostaw użyteczny skomentuj swoje przemyślenia, a następnie udostępnij to na swoich grupach na Facebooku, które uznają to za przydatne i wspólnie zbierzmy korzyści. Dziękuję za udostępnienie i bycie miłym!

Ujawnienie: Ta strona może zawierać linki do zewnętrznych witryn produktów, które kochamy i gorąco polecamy. Jeśli kupisz sugerowane przez nas produkty, możemy otrzymać opłatę za polecenie. Takie opłaty nie wpływają na nasze rekomendacje i nie przyjmujemy płatności za pozytywne recenzje.

Autorzy promowani w:  Inc Czasopismo Logo .   Logo Sitepoint   Logo CSS Tricks    logo webdesignerdepot   Logo WPMU DEV   i wiele więcej ...