Jak włączyć dzienniki błędów w WordPressie

Chociaż WordPress jest stosunkowo łatwy w zarządzaniu, rozwiązywanie problemów z błędami jest dość powszechnym problemem dla jego użytkowników. Radzenie sobie z nimi zwykle nie jest trudne – wystarczy trochę praktyki. Pierwszym krokiem każdego rozwiązywania problemów z błędami WordPress jest pobranie dziennika błędów.

Dziennik błędów zawiera wszystkie błędy, ostrzeżenia i powiadomienia dotyczące kodu Twojej witryny. Czasami może pomóc w określeniu dokładnego pliku i wiersza kodu, które powodują problem. Dziennik błędów może również dostarczyć wskazówek, jak rozwiązać pozornie nierozwiązywalne błędy, takie jak „biały ekran śmierci”.

Jednak zrozumienie dziennika błędów może być dość trudne, jeśli nie jesteś obeznany z technologią. Aby stać się obeznanym z technologią, musisz od czegoś zacząć – zacznijmy więc od pokazania, jak włączyć i uzyskać dziennik błędów w WordPressie.

Jak skonfigurować dzienniki błędów WordPress w pliku WP-Config

Plik wp-config.php jest ważnym plikiem konfiguracyjnym WordPress. Lekko go edytując, włączysz domyślne debugowanie WordPressa i wyświetlisz błędy. Możesz to zrobić za pośrednictwem klienta FTP lub cPanel.

Korzystanie z klienta FTP

Warunkiem wstępnym wykonywania jakichkolwiek zmian w plikach serwera jest prawidłowe ustawienie uprawnień do plików. Sugerowane uprawnienia do pliku wp-config.php to 440 lub 400. Oznacza to, że możesz tylko czytać pliki. Aby móc uzyskać dziennik błędów, musisz tymczasowo zmienić uprawnienia do pliku na 644 lub 666. Dla wyjaśnienia, 644 nadaje uprawnienia do odczytu i zapisu/edycji użytkownikom administracyjnym, podczas gdy pozostali użytkownicy otrzymują tylko uprawnienia do odczytu. Wartość 666 daje obydwa wyżej wymienione typy uprawnień wszystkim użytkownikom.

Aby kontynuować, potrzebujesz klienta FTP i wiedzy na temat edycji pliku wp-config.php. Zacznij od połączenia się z serwerem za pomocą swoich danych logowania FTP. Przejdź do swojego katalog główny WordPress. Znajdź plik wp-config.php, kliknij go prawym przyciskiem myszy i wybierz Opcja „Uprawnienia plików”.

Ręcznie wstaw jedną z sugerowanych wartości liczbowych (644 lub 666) i kliknij „ok”.

Po zmianie uprawnień wróć do katalog główny, kliknij prawym przyciskiem myszy plik wp-config.php i wybierz „Pokaż zmiany”.

Otwórz plik za pomocą edytora tekstu i wstaw ten wiersz kodu:

define('WP_DEBUG', true);

nad /* To wszystko, przestań edytować! Miłego blogowania. */.

Jeśli define('WP_DEBUG', false);  linia jest już obecna, tylko zamień fałsz na prawdę.

Zapisz zmiany i prześlij edytowany plik do głównego katalogu WordPress. Zastąpi to plik, który aktualnie znajduje się na twoim serwerze.

Przez cPanel

Możesz także użyć cPanel do edycji pliku wp-config.php. Zaloguj się do cPanel używając swoich danych logowania i kliknij „Menedżer plików”.

Przejdź do katalog główny instalacji WordPressa po lewej stronie, zlokalizuj plik wp-config.php, kliknij prawym przyciskiem myszy i wybierz „Zmień uprawnienia”.

Upewnij się włączyć zarówno uprawnienia do odczytu, jak i zapisu dla użytkownika (administratora) poprzez odznaczenie odpowiedniego pola wyboru. Następnie kliknij „Zmień uprawnienia”.

Następnie kliknij prawym przyciskiem myszy plik wp-config.php jeszcze raz i wybierz „Edytować”.

Plik otworzy się w domyślnym edytorze cPanel, więc wystarczy dodać define('WP_DEBUG', true); wyżej /* That's all, stop editing! Happy blogging. */ wiersz kodu w pliku wp-config.

Jeśli plik zawiera już następujący wiersz define('WP_DEBUG', false); po prostu zmień fałszywe na prawdziwe i kliknij „Zapisz zmiany” w prawym górnym rogu ekranu.

Jak zarządzać błędami wyświetlania

Gdy pomyślnie wyświetlisz błędy, pojawią się one na Twoich stronach, zarówno na zapleczu, jak i na froncie. O ile Twoja witryna nie jest w fazie rozwoju, ujawnianie błędów na żywo nie jest dobrym pomysłem. Zamiast tego powinieneś zapisać je jako pojedynczy plik i ukryć je w swojej witrynie. Umożliwi to późniejsze przeglądanie pliku i rozwiązywanie problemów w dowolnym momencie.

Aby to zrobić, dodaj ten kod do pliku wp-config.php.

define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Dodaj kod poniżej następującej linii define('WP_DEBUG', true);  i powyżej /* That's all, stop editing! Happy blogging. */ wiersz kodu.

Możesz edytować plik za pomocą klienta FTP lub cPanel, wykonując te same kroki, które przedstawiliśmy w poprzedniej sekcji. Po edycji plik wp-config.php powinien wyglądać tak.

Dodając define( 'WP_DEBUG_LOG’, true ); zmuszamy WordPress do przechowywania wszystkich komunikatów o błędach w jednym pliku. Domyślnie ten plik nazywa się debug.log i znajduje się w katalogu Twój-WordPress-root/wp-content/. Możesz także przechowywać komunikaty o błędach w innym utworzonym pliku. W takim przypadku zmień prawdę z „definiuj („WP_DEBUG_LOG”, prawda);” do ścieżki pliku. Na przykład:

define( 'WP_DEBUG_LOG', path-to-your-site/wp-content/error.log );

Ponadto, WP_DEBUG_DISPLAY określa, czy komunikaty o błędach są wyświetlane czy ukryte na ekranie. Dodając define( 'WP_DEBUG_DISPLAY’, false ); mówisz WordPressowi, aby ukrył wiadomości z ekranu, ale nadal są one drukowane w wyznaczonym pliku. Jeśli ty też dodaj @ini_set( 'display_errors’, 0 ); to wyłączy drukowanie błędów dla twojego PHP, upewniając się, że użytkownicy nie będą mogli ich zobaczyć w interfejsie.

Pobieranie dziennika błędów

Po wyświetleniu błędów i pomyślnym zapisaniu ich w odpowiednim pliku dziennika błędów jedyne, co pozostaje, to przejrzenie komunikatów o błędach i podjęcie dalszych kroków.

Ręczne pobieranie pliku debug.log

Aby pobrać plik dziennika, połącz się z serwerem, przejdź do swojego główny folder WordPress i kliknij wp-treść. Znaleźć debug.log plik w środku, kliknij prawym przyciskiem myszy na nim i naciśnij „Ściągnij”.

Zapisz plik na pulpicie. Następnie pamiętaj, aby cofnąć poprzednie zmiany. Obejmuje to usunięcie wstawionego kodu i zmianę uprawnień do pliku wp-config.php na 440 lub 400. Jeśli chcesz, możesz to zrobić po rozwiązaniu błędów.

Na koniec otwórz zapisany plik debug.log za pomocą edytora tekstu i sprawdź napisane komunikaty o błędach. W zależności od poziomu wiedzy możesz samodzielnie rozwiązać błędy lub zatrudnić programistę.

Bardziej zaawansowane funkcje debugowania

Przyjrzymy się również bardziej zaawansowanym możliwościom debugowania. Poniższy kod należy dodać w wp-config.php, nad /* That's all, stop editing! Happy blogging. */ linia.

Ten kod zmusza WordPressa do używania niezminifikowanych wersji plików CSS i JS, który jest przydatny do debugowania zmian i/lub błędów znalezionych w plikach CSS i JS.

Ustawiając stałą CONCATENATE_SCRIPTS na false, wymuszasz WordPress do ładowania wszystkich skryptów osobno. Może się to przydać do wyszukiwania wadliwych/niezgodnych skryptów.

Jeśli występują problemy z bazą danych, dobrym sposobem na rozpoczęcie debugowania jest analiza uruchomionych zapytań. Wstawiając powyższy kod, będziesz umieść treść zapytania, jaka funkcja je wywołała i jak długo było uruchomione w $wpdb->queries array. To pozwoli ci głębiej zagłębić się w backendową część kodu motywu i dokładnie to, co robi.

Możesz wtedy dodaj poniższy kod, aby wyświetlić wszystkie zapytania w czytelnej formie i analizuj je.

global $wpdb;
print("<pre>".print_r($wpdb->queries,true)."</pre>");

Pamiętaj jednak, że ten kod wpłynie na wydajność Twojej witryny, dlatego zalecamy używanie go wyłącznie do celów debugowania.

Końcowe przemyślenia

Postępując zgodnie z tym przewodnikiem, możesz wyświetlać i bezpiecznie przechowywać dzienniki błędów w pliku, zmieniać uprawnienia do plików i uruchamiać niektóre funkcje debugowania przeznaczone dla bardziej zaawansowanych użytkowników WordPressa. Ten samouczek pomoże Ci również dowiedzieć się więcej o sposobie działania Twojej witryny — więc trzymaj ją blisko, ponieważ możesz potrzebować tych instrukcji w przyszłości.