A WordPress fehér halálképernyője (WSOD): hogyan javítsd ki lépésről lépésre, fejlesztő nélkül

Ez az a reggel, amit soha nem szeretnél: megnyitod az oldaladat, és a főoldal helyett egy teljesen üres fehér képernyőt kapsz. Se szöveg, se hibaüzenet, se admin. Semmi. Ezt hívják „fehér halálképernyőnek” (WSOD), és bármennyire ijesztően néz is ki, a legtöbb esetben egyszerű, javítható oka van.

A jó hír: nem feltétlenül van szükséged fejlesztőre ahhoz, hogy átvészeld a pánik első hullámát. Egy nyugodt tervre van szükséged, a megfelelő sorrendben, hogy ne tedd rosszabbá a helyzetet. Az alábbiakban pontosan azok a lépések következnek, amelyeket egy szakember követ, amikor egy ilyen vészhívás beérkezik – a legegyszerűbbtől a legtechnikaibbig. Haladj végig rajtuk egyesével, és nagy valószínűséggel az oldalad visszatér.

Mi is valójában a WSOD, és miért történik

A fehér képernyő szinte mindig azt jelenti, hogy az oldaladat felépítő PHP egy súlyos hibával (egy „fatal error”-ral) leállt, és a WordPress soha nem jutott el odáig, hogy bármit is megjelenítsen. Biztonsági okokból a hibaüzenet rejtve marad a nyilvánosság elől – innen az üres lap.

A leggyakoribb okok kevesen vannak, és ismétlődnek:

• egy bővítmény- vagy sablonütközés, különösen közvetlenül egy frissítés után;
• egy túllépett PHP-memóriakorlát;
• egy kódhiba egy kézzel szerkesztett fájlban (gyakran a functions.php-ben);
• ritkán, egy szerver- vagy adatbázisprobléma.

A kulcs az, hogy ne találgass, hanem egyesével zárd ki a gyanúsítottakat. Mindenekelőtt, ha teheted, készíts biztonsági mentést a fájljaidról és az adatbázisodról. Egy beavatkozás előtti mentés megkíméli az idegeidet, ha valami balul sülne el.

1. lépés: kapcsold be a hibaüzeneteket, hogy lásd az okát

A fehér képernyő semmit sem mond neked – de rá tudod bírni, hogy megszólaljon. Ehhez fájlhozzáférésre lesz szükséged FTP-n, a cPanel Fájlkezelőjén vagy a tárhelyed vezérlőpultján keresztül.

Nyisd meg a wp-config.php fájlt az oldalad gyökérkönyvtárában, és keresd meg ezt a sort:

`define('WP_DEBUG', false);`

Cseréld le erre:

`define('WP_DEBUG', true);`

`define('WP_DEBUG_LOG', true);`

`define('WP_DEBUG_DISPLAY', false);`

Töltsd újra az oldalt. A hibák egy debug.log nevű fájlba íródnak a wp-content mappán belül. Nyisd meg, és olvasd el az utolsó sorokat: ezek általában pontosan megmondják, melyik bővítmény vagy fájl hibázott, a nevével és a sor számával együtt. Ez a legértékesebb nyom az egész műveletben. Miután megjavítottad a dolgokat, állítsd vissza a WP_DEBUG-ot false-ra, hogy a látogatók soha ne lássanak hibákat.

2. lépés: tiltsd le a bővítményeket, és válts sablont

A leggyakoribb bűnös egy bővítmény. Ha még el tudod érni az admint (wp-admin), kapcsold ki a bővítményeket egyesével, és tölts újra minden egyes után, amíg az oldal vissza nem tér.

Ha egyáltalán nem tudsz belépni az adminba, tedd meg a fájlokon keresztül:

• lépj be a wp-content mappába FTP-n vagy a Fájlkezelőn keresztül;
• nevezd át a plugins mappát valami olyanra, mint például plugins-off;
• ellenőrizd az oldalt.

Ha visszatér, egy bővítmény volt az ok. Nevezd vissza a mappát plugins-ra, majd tiltsd le a bővítményeket egyesével (az almappáik átnevezésével), amíg meg nem találod a bűnöst.

Ha a probléma továbbra is fennáll, teszteld a sablont: nevezd át az aktív sablon mappáját a wp-content/themes alatt. A WordPress egy alapértelmezett sablonra (például egy Twenty Twenty-valamire) fog visszaesni, és ha ez megoldja, akkor a sablonod volt a probléma.

3. lépés: emeld meg a PHP-memóriakorlátot

Ha a debug.log egy olyan üzenetet mutat, mint „Allowed memory size exhausted”, akkor az oldalad kifutott a memóriából. Ez egy egyszerű javítás.

A wp-config.php fájlban add hozzá ezt a sort a „That's all, stop editing” sor elé:

`define('WP_MEMORY_LIMIT', '256M');`

Ha ez nem elég, vagy nem engedik meg, hogy a WordPressből módosítsd, megemelheted a korlátot a php.ini fájlban vagy a tárhelyed vezérlőpultjáról (sok szolgáltatónál van egy PHP-beállítás, ahol közvetlenül a felületen választhatod ki a memória értékét).

Ha nincs hozzáférésed ezekhez a beállításokhoz, ez a megfelelő pillanat, hogy írj a tárhelyszolgáltatód ügyfélszolgálatának: gyakori kérés, és gyorsan elintézik. A kevés memória gyakran előfordul olcsó tárhelycsomagoknál, különösen sok bővítménnyel rendelkező oldalakon vagy egy WooCommerce üzletben.

4. lépés: állj vissza az utolsó jó verzióra, és mikor kérj segítséget

Ha minden egy frissítés vagy egy kézi szerkesztés után kezdődött, a legtisztább lépés visszatérni az azt megelőző állapotba. Ezért fontos a biztonsági mentés: egy friss másolattal visszaállítod a fájlokat és az adatbázist, és az oldal percek alatt újra online van.

Ha kézzel szerkesztetted a functions.php fájlt, és fehér képernyőt kaptál, akkor nagy valószínűséggel egy fölösleges zárójelet vagy pontosvesszőt hagytál benne. Nyisd meg a fájlt, és távolítsd el az utolsó módosítást, amit végrehajtottál.

Kérj szakembert, ha: nem találod a fájlokat, a hibák adatbázisproblémákra utalnak, vagy az oldal pénzt hoz neked, és minden leállással töltött óra pénzedbe kerül. Az MPO Web Studiónál távolról dolgozunk országszerte, és gyorsan tudunk vállalni ilyen vészhelyzetet – írj nekünk WhatsAppon, adj hozzáférést, és visszahozzuk online. Az új ügyfeleknek pedig tiszta szerkezetű oldalakat építünk, egy kész demóval, még mielőtt fizetnél, pontosan azért, hogy az ilyen ijedelmek ritkák maradjanak.