Cum să activați modul Debug în Joomla CMS: Depanarea erorilor site-ului

Atunci când se dezvoltă extensii personalizate, se aplică șabloane sau se gestionează actualizări pe un portal Joomla CMS, pot apărea conflicte software neașteptate. Un site poate afișa brusc un ecran gol (cunoscut în mod obișnuit ca “Ecranul Alb al Morții”) sau poate eșua în redarea corectă a componentelor de layout în urma unei actualizări de sistem.

În mod implicit, Joomla ascunde avertismentele detaliate privind codul de la vederea publicului pentru a proteja parametrii infrastructurii împotriva actorilor rău intenționați. Pentru a identifica și a rezolva buclele din baza de date, suprascrierile de clase defecte sau anomaliile scripturilor, trebuie să activați temporar funcțiile interne de diagnosticare ale Joomla. Activarea Modului de depanare și ajustarea setărilor de urmărire a erorilor din cadrul framework-ului dvs. expune căile de eroare subiacente, permițându-vă să rezolvați problemele în mod eficient.

Metoda 1: Activarea modului de depanare prin panoul de administrare

Dacă panoul de administrare Joomla rămâne accesibil, puteți activa diagnosticarea sistemului în condiții de siguranță prin intermediul panoului grafic de administrare, fără a modifica manual fișierele de configurare.

1. Conectați-vă la panoul de administrare Joomla.
2. Accesați opțiunile de configurare globală:
   • În Joomla 4 și Joomla 5: Selectați Sistem din bara laterală de navigare principală, apoi faceți clic pe Configurare globală.
   • În Joomla 3: Selectați Sistem din bara de meniu de sus, apoi faceți clic pe Configurare globală.
3. Faceți clic pe fila Sistem situată în rândul superior de selecție a configurației.
4. Localizați setarea de configurare denumită Sistem de depanare și comutați comutatorul parametrului de la Nu la Da.
5. Apoi, pentru a vedea urmele detaliate ale erorilor alături de jurnalele de sistem, faceți clic pe fila Server.
6. Găsiți blocul de parametri intitulat Raportare erori. Comutați această opțiune de la Implicit sistem la Maxim sau Dezvoltare.
7. Faceți clic pe butonul Salvare și închidere din zona superioară a barei de instrumente pentru a aplica instantaneu noile setări.

Metoda 2: Activarea modului de depanare prin fișierul configuration.php

Dacă o excepție fatală de script blochează complet accesul la panoul de administrare, nu puteți utiliza panoul de configurare din backend. În schimb, trebuie să editați manual fișierul principal de mediu al Joomla folosind un client FTP sau exploratorul de fișiere din panoul de control al gazdei dvs.

1. Stabiliți o conexiune la distanță la spațiul dvs. web folosind un client FTP (cum ar fi FileZilla).
2. Navigați la folderul rădăcină în care sunt stocate fișierele directorului Joomla (de obicei în public_html).
3. Localizați fișierul central de configurare numit configuration.php.
4. Descărcați o copie de rezervă locală a acestui fișier pe computerul dvs. înainte de a efectua orice modificări, pentru a păstra starea inițială de funcționare.
5. Deschideți fișierul de pe server într-un editor de text și localizați următoarele variabile operaționale:

public $debug = '0';
public $error_reporting = 'default';

6. Modificați parametrii pentru a activa afișarea maximă a blocurilor de diagnosticare în toate șabloanele de layout ale framework-ului:

public $debug = '1';
public $error_reporting = 'development';

7. Salvați modificările și încărcați din nou fișierul modificat pe server, suprascriind versiunea anterioară.

Interpretarea matricei de ieșire de depanare

Odată ce aceste funcții de diagnosticare sunt activate, un container grafic specializat pentru consolă, denumit Joomla! Debug Console, va apărea chiar în partea de jos a paginii dvs. web. Această consolă compilează date esențiale privind performanța infrastructurii:

• Parametrii sesiunii: Afișează detaliile de autentificare active, token-urile de acces și nivelurile de permisiuni asociate sesiunii browserului de vizualizare.
• Jurnale de interogări ale bazei de date: Enumeră fiecare interogare SQL executată în timpul ciclului activ de compilare a paginii. Evidențiază apelurile duplicate și identifică căutările neoptimizate în tabele care ar putea cauza scăderi de performanță la execuție.
• Rezerve de alocare a memoriei: Urmărește volumul exact de memorie RAM a serverului consumat de solicitarea paginii active, ajutându-vă să identificați scurgerile de memorie din pluginurile terțe.
• Urmăriri complete ale stivei de erori: În loc să afișeze un ecran gol, Joomla va afișa calea specifică a fișierului, numele funcției care a eșuat și numărul exact al liniei de cod responsabile de blocarea site-ului.