WordPress debug mode helps display or save technical errors that are not always visible on the website. It is useful when a WordPress website shows a blank page, a critical error, a 500 error, or unexpected behavior after a plugin, theme, or PHP change.
Debug mode should usually be enabled only while troubleshooting. After the issue is identified, it should be disabled again to avoid storing unnecessary error logs or showing technical information.
Table of Contents
Before you start
Pentru a activa modul de depanare WordPress, aveți nevoie de acces la fișierele site-ului web. Setarea se adaugă în fișierul wp-config.php, care se află în directorul principal al WordPress.
Puteți accesa fișierul folosind FTP sau SFTP.
Articol conex: Cum se creează un cont FTP nou
Cum se activează modul de depanare în WordPress
- Conectați-vă la fișierele site-ului dvs. web folosind FTP sau SFTP.
- Deschideți directorul principal al site-ului dvs. WordPress.
- Găsiți fișierul numit
wp-config.php. - Descărcați o copie de rezervă a fișierului înainte de a-l edita.
- Deschideți fișierul
wp-config.phpîntr-un editor de text. - Căutați această linie:
define( 'WP_DEBUG', false );
- Înlocuiți-o cu următorul cod:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );
- Salvați fișierul.
- Încărcați fișierul actualizat
wp-config.phpînapoi pe server dacă l-ați editat local. - Deschideți din nou site-ul web și repetați acțiunea care a cauzat problema.
WordPress va salva acum erorile detectate într-un fișier jurnal, în loc să le afișeze direct vizitatorilor.
Unde salvează WordPress jurnalul de depanare
Când WP_DEBUG_LOG este activat, WordPress salvează de obicei erorile în acest fișier:
wp-content/debug.log
Deschideți acest fișier după ce ați reprodus problema. Cele mai recente erori sunt de obicei adăugate la sfârșitul fișierului.
Jurnalul poate menționa un plugin, o temă, o funcție PHP, un fișier lipsă sau o problemă legată de baza de date. Aceste informații ajută la identificarea cauzei problemei.
Articol conex: Cum să verificați dacă există erori în CMS WordPress
Ce înseamnă setările de depanare
define( 'WP_DEBUG', true );
Aceasta activează modul de depanare al WordPress.
define( 'WP_DEBUG_LOG', true );
Aceasta îi indică WordPress-ului să salveze erorile într-un fișier jurnal.
define( 'WP_DEBUG_DISPLAY', false );
Aceasta împiedică afișarea erorilor direct pe site.
@ini_set( 'display_errors', 0 );
Aceasta ajută la ascunderea erorilor tehnice de vizitatori, în timp ce acestea sunt totuși salvate în jurnal.
Această configurație este, de obicei, mai sigură pentru site-urile active, deoarece înregistrează erorile fără a le afișa public.
Dacă site-ul afișează o eroare 500
O eroare 500 înseamnă că serverul nu a putut finaliza solicitarea. În WordPress, aceasta este adesea cauzată de un plugin, o temă, o schimbare a versiunii PHP, un fișier corupt sau o problemă de configurare.
După activarea modului de depanare, verificați fișierul debug.log pentru a afla mesajul exact al erorii.
Articol conex: Eroarea 500 – Eroare internă a serverului
Dacă eroarea indică un plugin
Dacă jurnalul de depanare arată că un plugin cauzează problema, puteți dezactiva acel plugin fără a vă autentifica în panoul de administrare WordPress.
Acest lucru este util atunci când nu aveți acces la panoul de control WordPress.
Articol conex: Cum să dezactivați un plugin în WordPress fără a accesa panoul de administrare
Cum se dezactivează modul de depanare
După rezolvarea problemelor, deschideți din nou wp-config.php și schimbați modul de depanare înapoi la:
define( 'WP_DEBUG', false );
De asemenea, puteți elimina aceste linii dacă au fost adăugate doar pentru depanare:
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );
Dacă fișierul wp-content/debug.log conține multe erori vechi, îl puteți descărca pentru referință și apoi îl puteți șterge de pe server.
La ce să vă așteptați
Modul de depanare nu rezolvă problema de la sine. Acesta ajută la identificarea sursei problemei.
În majoritatea cazurilor, jurnalul indică un plugin, o temă, o problemă de compatibilitate PHP, un fișier lipsă sau o eroare legată de baza de date. Odată ce cauza este identificată, următorul pas este să actualizați, să dezactivați, să reparați sau să reconfigurați partea afectată a site-ului web.
Rezumat
Modul de depanare WordPress este utilizat pentru a colecta informații tehnice despre erori în timpul depanării. Cea mai sigură abordare pe un site web activ este să salvați erorile în wp-content/debug.log, păstrându-le ascunse de vizitatori.
După identificarea problemei, modul de depanare trebuie dezactivat din nou.