Cum rezolvați ecranul alb al morții în WordPress

Ecranul alb al morții (White Screen of Death) este una dintre cele mai frecvente și frustrante erori WordPress. Website-ul afișează o pagină complet albă, fără niciun mesaj de eroare, iar panoul admin poate fi și el inaccesibil.

Situația este cu atât mai stresantă cu cât nu există nicio indicație vizibilă despre ce anume a mers greșit – pur și simplu pagina albă înlocuiește brusc conținutul normal al website-ului, fără avertisment prealabil.

Deși termenul sună alarmant, în majoritatea cazurilor ecranul alb poate fi rezolvat în câteva minute odată ce identificați cauza. Cele mai frecvente cauze sunt: un plugin incompatibil după actualizare, o temă cu erori de cod, limita de memorie PHP depășită sau un fișier WordPress core corupt.

Abordarea sistematică a fiecărei cauze posibile duce la rezolvarea rapidă a problemei, chiar și fără acces la panoul de administrare.

În acest ghid veți descoperi toate cauzele posibile ale ecranului alb în WordPress și metodele pas cu pas pentru diagnosticarea și rezolvarea fiecăreia. Fie că eroarea a apărut brusc sau după o actualizare recentă, pașii prezentați vă ghidează de la diagnosticare la soluție în mod eficient, fără a fi nevoie de cunoștințe tehnice avansate.

Cum rezolvați ecranul alb al morții în WordPress

Ecranul alb apare când PHP întâlnește o eroare fatală și nu poate genera pagina HTML. WordPress ascunde implicit aceste erori pentru securitate, afișând în locul lor o pagină albă goală care nu dezvăluie detalii tehnice vizitatorilor. Puteți activa temporar afișarea erorilor pentru diagnosticare. Parcurgeți soluțiile în ordinea prezentată – fiecare pas testează o cauză diferită și elimină sistematic posibilitățile.

Activarea modului debug

Primul pas este să aflați ce eroare exactă cauzează ecranul alb. Accesați fișierul wp-config.php prin File Manager din cPanel sau prin FTP și adăugați aceste linii imediat înainte de linia care conține „That’s all, stop editing!”:

// Activează modul debug
define('WP_DEBUG', true);

// Salvează erorile într-un fișier log
define('WP_DEBUG_LOG', true);

// Nu afișa erorile pe ecran (pentru website-uri live)
define('WP_DEBUG_DISPLAY', false);

După salvare, accesați website-ul din nou. Erorile vor fi salvate în fișierul wp-content/debug.log. Deschideți acest fișier și căutați ultima eroare înregistrată – aceasta indică de obicei cauza exactă a ecranului alb. Mesajul de eroare include tipul erorii (Fatal error, Parse error etc.), fișierul afectat și numărul liniei exacte, informații care vă ghidează direct spre soluție.

Dacă preferați să vedeți erorile direct pe ecran în loc de fișierul log, schimbați WP_DEBUG_DISPLAY la true. Faceți acest lucru doar dacă website-ul nu este accesibil public sau dacă lucrați în afara orelor de trafic, pentru a evita expunerea detaliilor tehnice vizitatorilor.

Creșterea limitei de memorie PHP

O limită de memorie prea mică este o cauză frecventă a ecranului alb, în special pe website-uri cu multe pluginuri sau cu WooCommerce activ. Când PHP încearcă să aloce mai multă memorie decât permite limita configurată, procesul se oprește brusc, generând ecranul alb fără niciun mesaj suplimentar.

Creșteți limita de memorie adăugând în wp-config.php, înainte de linia „That’s all, stop editing!”:

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

Dacă această modificare nu are efect, creșteți și limita PHP globală. Editați fișierul php.ini sau folosiți un fișier .user.ini în directorul rădăcină al website-ului:

memory_limit = 512M

Puteți modifica limita de memorie și din setările PHP din cPanel – secțiunea MultiPHP INI Editor, fără a fi nevoie să editați manual fișierele de configurare. Această opțiune este mai accesibilă și elimină riscul de erori de sintaxă în fișierele de configurare.

Dezactivarea pluginurilor

Pluginurile incompatibile sau cu erori de cod sunt cea mai frecventă cauză a ecranului alb în WordPress, în special după actualizări. Există două scenarii diferite în funcție de accesibilitatea panoului de administrare.

Dacă aveți acces la panoul admin

Dacă panoul admin funcționează dar frontend-ul afișează ecranul alb, navigați la Plugins și dezactivați toate pluginurile simultan prin selectarea tuturor și folosind acțiunea „Deactivate” din meniul dropdown. Dacă website-ul revine la normal, reactivați pluginurile unul câte unul, verificând după fiecare reactivare dacă ecranul alb reapare. Pluginul care provoacă reapariția problemei este cel vinovat.

Dacă nu aveți acces la panoul admin

Accesați File Manager din cPanel sau conectați-vă prin FTP și navigați la directorul wp-content. Redenumiți directorul plugins în plugins-disabled:

wp-content/plugins → wp-content/plugins-disabled

Acest lucru dezactivează toate pluginurile simultan, deoarece WordPress nu le mai găsește în locația așteptată. Dacă website-ul revine la normal, cauza este un plugin. Redenumiți directorul înapoi la plugins, apoi redenumiți fiecare subdirector de plugin individual pentru a identifica pe cel problematic. Adăugați un sufix „-disabled” la fiecare subdirector de plugin pe rând, verificând după fiecare modificare dacă ecranul alb dispare.

• wp-content/plugins/plugin-suspect-disabled – testați dacă problema dispare
• Dacă problema dispare, ați identificat pluginul vinovat
• Dacă problema persistă, redenumiți înapoi și treceți la următorul plugin
• Continuați până identificați pluginul care cauzează ecranul alb

Schimbarea temei

Dacă dezactivarea pluginurilor nu rezolvă problema, cauza poate fi tema activă. O temă cu erori PHP, incompatibilă cu versiunea curentă de WordPress sau de PHP, poate cauza ecranul alb la fel ca un plugin problematic.

Schimbați tema prin baza de date din phpMyAdmin urmând acești pași:

1. Accesați phpMyAdmin din cPanel
2. Selectați baza de date WordPress din lista din stânga
3. Deschideți tabelul wp_options (prefixul poate diferi dacă ați schimbat prefixul implicit)
4. Căutați rândurile cu option_name: template și stylesheet folosind câmpul de căutare
5. Schimbați valoarea ambelor câmpuri la o temă implicită WordPress (de exemplu twentytwentyfour)
6. Salvați modificările și accesați din nou website-ul

Dacă website-ul revine la normal după schimbarea temei, tema anterioară conține o eroare de cod sau este incompatibilă cu versiunea curentă de WordPress sau PHP. Contactați dezvoltatorul temei sau actualizați tema la ultima versiune disponibilă pentru a rezolva incompatibilitatea.

Verificarea fișierelor WordPress core

Fișierele WordPress core pot fi corupte după o actualizare eșuată, un atac de securitate sau o eroare de server în timpul transferului de fișiere. Un fișier core corupt poate cauza ecranul alb chiar și atunci când toate pluginurile și temele sunt dezactivate.

Reinstalați WordPress core fără a afecta conținutul, urmând acești pași:

1. Descărcați cea mai recentă versiune WordPress de pe wordpress.org în format arhivă ZIP
2. Extrageți arhiva pe calculatorul local
3. Încărcați directoarele wp-admin și wp-includes peste cele existente pe server, suprascriind toate fișierele
4. Încărcați fișierele din rădăcina arhivei (wp-login.php, wp-cron.php, wp-settings.php etc.) fără a suprascrie wp-config.php și .htaccess

Nu suprascrieți directorul wp-content – acesta conține temele, pluginurile și fișierele media ale website-ului dumneavoastră. Reinstalarea core-ului nu afectează conținutul website-ului sau setările din baza de date.

Verificarea fișierului .htaccess

Un fișier .htaccess corupt sau cu directive invalide poate cauza ecranul alb sau erori 500 Internal Server Error. Pluginurile de securitate, pluginurile de caching sau modificările manuale pot introduce cod problematic în .htaccess.

Redenumiți fișierul .htaccess existent în .htaccess-backup și creați unul nou minimal cu conținutul standard WordPress:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Dacă problema se rezolvă, cauza era un cod adăugat în .htaccess de un plugin sau o configurare manuală greșită. Comparați noul fișier cu backup-ul pentru a identifica directivele problematice și adăugați-le înapoi pe rând pentru a găsi pe cea care cauzează problema.

Alte cauze și soluții

Eroare de sintaxă PHP

Dacă ați editat manual un fișier PHP – funcții.php al temei, wp-config.php sau orice alt fișier WordPress – și ați introdus o eroare de sintaxă (o virgulă lipsă, o paranteză neînchisă, un ghilimele neînchis), website-ul va afișa ecranul alb imediat după salvare. Verificați debug.log pentru mesajul de eroare exact care include numele fișierului și linia cu problema:

// Exemplu de mesaj de eroare în debug.log
PHP Parse error: syntax error, unexpected '}' in
/home/user/public_html/wp-content/themes/tema-mea/functions.php on line 47

Corectați eroarea în fișierul indicat sau restaurați fișierul din backup dacă nu puteți identifica rapid problema. Pentru editarea fișierelor PHP este recomandat un editor de cod cu evidențierea erorilor de sintaxă, care detectează problemele înainte de salvare.

Limita de timp de execuție

Operațiunile complexe, importurile de date mari sau interogările de bază de date lente pot depăși limita de timp de execuție PHP, generând ecranul alb la mijlocul procesării. Creșteți-o din php.ini sau din fișierul .user.ini:

max_execution_time = 300

Dacă ecranul alb apare doar în timpul unor operații specifice (import, export, generare de rapoarte), limita de timp este o cauză probabilă. Dacă apare pe toate paginile în mod constant, verificați mai întâi celelalte cauze prezentate în acest ghid.

Spațiu pe disc insuficient

Verificați spațiul disponibil pe disc din cPanel. Un server cu disc plin nu poate genera pagini sau salva fișiere temporare, cauzând ecranul alb. Această cauză este mai puțin frecventă, dar este una dintre puținele care nu generează erori PHP în debug.log – dacă PHP nu poate scrie fișierul log, debug.log va rămâne gol sau va fi absent chiar și cu modul debug activat.

Conflicte între versiunea PHP și cod

O actualizare a versiunii PHP pe server poate face incompatibil codul unor pluginuri sau teme mai vechi care folosesc funcții PHP depreciate sau eliminate. Verificați dacă ecranul alb a apărut după o modificare a versiunii PHP și, dacă da, reveniți temporar la versiunea anterioară din cPanel – MultiPHP Manager – pentru a confirma că aceasta este cauza.

// Exemplu de eroare cauzată de incompatibilitate PHP
PHP Fatal error: Uncaught Error: Call to undefined function ereg()
in /home/user/public_html/wp-content/plugins/plugin-vechi/file.php on line 23

Funcția ereg() a fost eliminată începând cu PHP 7. Dacă vedeți acest tip de eroare, pluginul sau tema respectivă trebuie actualizată sau înlocuită cu o variantă compatibilă cu versiunea PHP actuală.

Prevenirea ecranului alb

Cele mai multe apariții ale ecranului alb sunt evitabile prin practici de întreținere preventivă. Implementați aceste măsuri pentru a reduce semnificativ riscul:

• Mențineți backup-uri regulate pentru restaurare rapidă – un backup recent reduce timpul de recuperare la câteva minute
• Actualizați pluginurile și temele sistematic, verificând compatibilitatea cu versiunea WordPress și PHP înainte de actualizare
• Nu editați manual fișierele PHP ale temei active – folosiți un child theme și un editor de cod cu verificare de sintaxă
• Mențineți limita de memorie PHP la cel puțin 256 MB pentru website-urile cu pluginuri multiple
• Verificați periodic jurnalele de erori pentru avertismente care pot indica probleme viitoare, înainte de a deveni critice
• Folosiți versiunea PHP recomandată de WordPress și actualizați-o treptat, testând compatibilitatea
• Testați actualizările majore pe un mediu de staging înainte de a le aplica pe website-ul de producție
• Eliminați pluginurile inactive din instalare – un plugin dezactivat dar prezent pe server poate fi totuși o sursă de vulnerabilități

Ecranul alb al morții în WordPress pare intimidant, dar este aproape întotdeauna rezolvabil. Urmați pașii din acest ghid în ordine – activați debug, verificați memoria, dezactivați pluginurile, schimbați tema, verificați fișierele core – și veți identifica cauza în câteva minute. Cel mai important lucru pe care îl puteți face pentru prevenire este să mențineți backup-uri regulate care vă permit restaurarea rapidă în orice situație.