Sari la conținut

Activează depanarea în WordPress

Modul debug din WordPress afișează sau înregistrează erori PHP, notificări și avertismente. Îl folosești când vezi ecran alb, eroare 500 sau o funcție care nu mai răspunde.

Poți activa depanarea:

Pe un site public, scrie mesajele în jurnal și nu le afișa în pagină. Dezactivează depanarea după ce ai terminat.

Încearcă mai întâi pe o copie de test, dacă poți reproduce problema acolo. Notează setările inițiale și folosește una dintre metodele de mai jos, nu toate simultan. Depanarea înregistrează indicii despre problemă, nu o repară automat.

  1. Intră în panoul de control din zona de client cu Login to Panel, sau deschide direct panoul serviciului.
  2. În Websites, selectează site-ul.
  3. Deschide Apps și apasă Toolkit pe cardul instalării WordPress.

Butonul Toolkit din Apps în Enhance, cu domeniul mascat

  1. Deschide secțiunea Debug.
  2. Verifică mai întâi că WP_DEBUG_DISPLAY este dezactivat, ca mesajele să nu apară vizitatorilor.
  3. Activează WP_DEBUG_LOG pentru înregistrarea în wp-content/debug.log, apoi WP_DEBUG pentru pornirea depanării. Jurnalizarea funcționează numai cu WP_DEBUG activ.

Secțiunea Debug din Enhance, cu cele trei comutatoare dezactivate și datele contului mascate

Captura arată starea dezactivată. Pentru diagnostic, WP_DEBUG și WP_DEBUG_LOG trebuie să fie active, iar WP_DEBUG_DISPLAY să rămână dezactivat. Nu folosi butonul Delete de sub secțiune; acesta nu oprește depanarea.

Reproduce problema și urmează pașii de mai jos pentru citirea jurnalului. La final, oprește depanarea.

Detaliile fiecărui comutator sunt pe pagina Instrumente WordPress.

  1. Deschide cPanel din zona de client (Login to cPanel) sau la domeniultau.ro/cpanel.
  2. Intră în Domains → WordPress Management și selectează instalarea.
  3. În Tools, găsește Debugging. Deschide mai întâi pictograma Settings de lângă comutator, pentru a verifica ce opțiuni vei activa.

Comutatorul Debugging în cPanel WordPress Management, cu domeniul mascat

  1. Bifează WP_DEBUG și WP_DEBUG_LOG, debifează WP_DEBUG_DISPLAY și salvează setările. Verifică apoi că Debugging este activ.

Setări avansate debug în cPanel, cu domeniul mascat

În captura de mai sus, WP_DEBUG_DISPLAY este bifat și WP_DEBUG_LOG este debifat. Nu reproduce această combinație pe un site public; folosește valorile de la pasul 4.

  • WP_DEBUG - activează modul debug
  • WP_DEBUG_LOG - scrie în wp-content/debug.log
  • WP_DEBUG_DISPLAY - afișează mesajele în HTML (ține-l dezactivat pe site-uri publice)
  • SCRIPT_DEBUG - folosește versiunile de dezvoltare ale fișierelor JS și CSS
  • SAVEQUERIES - înregistrează interogările MySQL pentru depanare

Lasă SCRIPT_DEBUG și SAVEQUERIES dezactivate dacă nu investighezi acele componente. SAVEQUERIES consumă resurse suplimentare. După diagnostic, dezactivează Debugging.

  1. Deschide File Manager în Enhance sau File Manager în cPanel.
  2. Intră în folderul instalării WordPress, unde se află wp-admin, wp-content și wp-includes. Acesta este adesea public_html, dar poate fi un alt document root sau un subfolder.
  3. Selectează wp-config.php și descarcă o copie pe calculator, într-un loc privat. Fișierul conține datele de conectare la baza de date; nu lăsa o copie .bak sau .txt în folderul public.
  4. Deschide fișierul cu Edit și caută WP_DEBUG.

Găsește linia existentă:

define( 'WP_DEBUG', false );

Înlocuiește-o cu blocul de mai jos, înainte de /* That's all, stop editing! Happy publishing. */. Dacă sunt definite deja și celelalte constante, schimbă-le valorile în loc să le duplici:

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

Salvează fișierul, reproduce eroarea o singură dată, apoi citește wp-content/debug.log. Dacă jurnalul nu apare, verifică dacă WordPress poate scrie în wp-content și consultă jurnalul PHP din panoul de control. După diagnostic, revino la valorile inițiale din copia salvată.

Scrie true și false fără ghilimele. Dacă site-ul afișează o eroare nouă imediat după editare, revino la copia salvată a wp-config.php. Vezi și documentația WordPress despre depanare.

  1. Notează ora și acțiunea care nu funcționează, apoi reproduce problema o singură dată.
  2. În File Manager, deschide folderul instalării WordPress, apoi wp-content.
  3. Selectează debug.log și descarcă-l pentru a-l citi local. Nu îl deschide prin URL-ul public al site-ului. Dacă WP_DEBUG_LOG conține o cale personalizată în loc de true, caută jurnalul la acea cale.
  4. Mergi la sfârșitul fișierului și caută mesajele din intervalul testului. Verifică fusul orar din jurnal înainte să compari orele.
  5. Pentru o eroare critică, caută Fatal error, Uncaught sau Parse error. Notează mesajul, fișierul și linia indicate. O avertizare Warning sau Deprecated nu dovedește singură cauza blocării.

Nu șterge un fișier de plugin sau din WordPress doar pentru că apare în jurnal. Trimite fragmentul relevant printr-un tichet de suport, împreună cu URL-ul afectat, ora testului și acțiunea efectuată. Elimină parolele, tokenurile și datele personale care nu sunt necesare investigației.

  • Verifică dacă WP_DEBUG și WP_DEBUG_LOG sunt ambele active pentru instalarea corectă.
  • Jurnalul poate lipsi dacă testul nu a produs mesaje PHP sau dacă pagina a fost servită integral din cache.
  • Verifică dacă este definită o cale personalizată și dacă WordPress poate scrie acolo. Nu aplica permisiuni 777 ca soluție.
  • Dacă eroarea apare înainte să se încarce WordPress, verifică jurnalul PHP al site-ului sau cere suportului să îl verifice. Lipsa debug.log nu înseamnă că site-ul nu are erori.
  1. În Enhance, revino la Apps → Toolkit → Debug și dezactivează WP_DEBUG, apoi WP_DEBUG_LOG. Lasă WP_DEBUG_DISPLAY dezactivat.
  2. Dacă ai folosit cPanel, oprește Debugging. Dacă ai editat manual fișierul, setează constantele existente WP_DEBUG, WP_DEBUG_LOG și WP_DEBUG_DISPLAY la false, fără să adaugi definiții duplicate.
  3. Dezactivează și SCRIPT_DEBUG sau SAVEQUERIES dacă le-ai activat pentru test. Reîncarcă pagina afectată și verifică faptul că nu apar mesaje de depanare.
  4. După ce ai păstrat local fragmentul necesar investigației, elimină jurnalul din folderul public. Oprirea depanării nu șterge mesajele deja înregistrate.