Képzelje el a legrosszabbat: órákat, napokat, heteket töltött WordPress oldalának építésével, finomhangolásával, tartalom feltöltésével. Egy szép napon – talán egy frissítés után, talán anélkül, hogy bármit is csinált volna – megpróbálja megnyitni a webhelyet, és az üdvözlő tartalom helyett egy rideg, fehér képernyő bámul vissza Önre. Semmi hibaüzenet, semmi tartalom, csak a teljes üresség. Üdv a rettegett WordPress Fehér Halál Képernyő (WSOD) világában!
Ne essen pánikba! Bár a látvány ijesztő, és az első reakció gyakran a teljes kétségbeesés, a fehér halál képernyő az egyik leggyakoribb WordPress probléma, és a legtöbb esetben szerencsére orvosolható. Ez az átfogó útmutató lépésről lépésre végigvezeti Önt a lehetséges okokon és a hibaelhárítási folyamaton, hogy minél hamarabb újra talpra állíthassa webhelyét.
Mi az a Fehér Halál Képernyő és miért jelenik meg?
A Fehér Halál Képernyő (angolul White Screen of Death, WSOD) lényegében azt jelenti, hogy a WordPress-nek valahol súlyos hibája van, de nem képes megjeleníteni a hibaüzenetet, vagy nem engedi, hogy a szerver megjelenítse azt. Ezáltal a böngésző csak egy üres, fehér oldalt kap válaszul. A WSOD leggyakoribb okai a következők:
- PHP memória limit túllépése: Ez a leggyakoribb bűnös. Ha a WordPress vagy egy plugin túl sok memóriát prób meg felhasználni, mint amennyi megengedett, a szerver leállítja a folyamatot, és eredményül egy üres oldalt kapunk.
- Plugin vagy téma konfliktus: Egy újonnan telepített vagy frissített plugin/téma, vagy két plugin/téma ütközése gyakran okoz WSOD-ot.
- Hibásan megírt kód vagy szintaktikai hiba: Egy elgépelés, hiányzó zárójel vagy más programozási hiba a
functions.php
fájlban, vagy egyéni kódban könnyen leállíthatja az egész oldalt. - Korrupt WordPress magfájlok: Bár ritka, de előfordulhat, hogy a WordPress alapvető fájljai megsérülnek egy frissítés vagy szerverhiba során.
- Adatbázis probléma: Az adatbázis sérülése is okozhatja, hogy az oldal nem tud betöltődni.
- Szerverproblémák: Extrém esetekben a tárhelyszolgáltató oldalon fellépő hiba is vezethet WSOD-hoz, bár ilyenkor általában más hibakódok is megjelennek.
Az első és legfontosabb lépés: Ne essen pánikba!
Mielőtt bármilyen drasztikus lépést tenne, vegyen egy mély lélegzetet. A pánik rossz tanácsadó. Fontos, hogy logikusan és módszeresen haladjunk a probléma elhárításában. Emellett, remélhetőleg, rendelkezik egy friss tartalék mentéssel. Ha igen, máris félig nyert ügye van! Ha nem, akkor most a lehető leggyorsabban igyekezzünk megoldani a problémát, és jegyezze meg, hogy a jövőben a rendszeres biztonsági mentés elengedhetetlen.
Felkészülés a hibaelhárításra: Hozzáférések
A fehér halál képernyő esetén valószínűleg nem fér hozzá a WordPress admin felületéhez. Ezért a hibaelhárításhoz szüksége lesz:
- FTP/SFTP hozzáférés: Ez lehetővé teszi, hogy közvetlenül módosítsa a WordPress fájlokat a szerveren. Használjon egy FTP klienst, mint például a FileZilla.
- Tárhely admin felület (cPanel, Plesk stb.): Ezen keresztül érheti el a fájlkezelőt (ha nem használ FTP-t), a phpMyAdmin-t az adatbázis eléréséhez, és ellenőrizheti a szerver naplókat.
Lépésről lépésre a probléma elhárításában:
1. Engedélyezze a WordPress hibakereső módot (Debug Mode)
Mivel a WSOD nem mondja meg, mi a baj, nekünk kell megkérdeznünk tőle. A WordPress beépített hibakeresője (debug mode) gyakran felfedi a problémát okozó PHP hibákat.
Ehhez lépjen be az FTP klienssel a webhely gyökérkönyvtárába, és keresse meg a wp-config.php
fájlt. Nyissa meg szerkesztésre, és keresse meg a következő sort:
define( 'WP_DEBUG', false );
Módosítsa true
-ra:
define( 'WP_DEBUG', true );
Ezután adja hozzá az alábbi két sort közvetlenül alá (ha még nincsenek ott), hogy a hibák ne jelenjenek meg a frontend felületen, hanem egy fájlba legyenek mentve:
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Mentse a fájlt, és töltse vissza a szerverre. Most frissítse az oldalt. Ha megjelenik egy hibaüzenet a képernyőn, az azonnal megmondhatja, melyik fájl vagy sor a hibás. Ha még mindig fehér a képernyő, de a WP_DEBUG_LOG
be van kapcsolva, akkor keresse meg a wp-content
mappában lévő debug.log
fájlt. Ebben a fájlban rögzítésre kerülnek a PHP hibák, amelyek segítenek azonosítani a gyökérproblémát. Ha megtalálta a hibaüzenetet, gyakran már tudja, melyik plugin, téma vagy kódsor a bűnös.
2. Növelje a PHP memória limitet
Ha a debug.log
fájlban vagy a képernyőn egy „Allowed memory size of X bytes exhausted” típusú hibaüzenetet lát, akkor a probléma a PHP memória limittel van.
Nyissa meg ismét a wp-config.php
fájlt, és adja hozzá a következő sort közvetlenül a define( 'WP_DEBUG', false );
(vagy true) sor alá, vagy módosítsa, ha már létezik:
define( 'WP_MEMORY_LIMIT', '256M' );
Mentse, és töltse fel a fájlt. A 256M általában elegendő, de szükség esetén növelhető. Ha ez sem segít, megpróbálhatja a php.ini
fájlt (ha van hozzáférése hozzá a tárhelyen), vagy a .htaccess
fájlt szerkeszteni a gyökérkönyvtárban. A .htaccess
fájlba adja hozzá a következő sort:
php_value memory_limit 256M
Fontos, hogy csak az egyik módszert használja a három közül, nehogy konfliktusba kerüljenek egymással.
3. Deaktiválja az összes plugint
A plugin konfliktusok a WSOD leggyakoribb okai. Mivel nem fér hozzá az admin felülethez, manuálisan kell deaktiválnia őket.
Lépjen be FTP-n keresztül a wp-content
mappába, azon belül pedig a plugins
mappába. Nevezze át a plugins
mappát például plugins_old
névre. Ezzel a WordPress nem találja a pluginokat, és automatikusan inaktiválja őket.
Most frissítse az oldalt. Ha az oldal betöltődik (akár fehér képernyő nélkül, akár az alapértelmezett WordPress felületet látja), akkor biztos, hogy egy plugin okozta a problémát. Nevezze vissza a mappát plugins
-ra, majd egyenként aktiválja újra a pluginokat a WordPress admin felületén (most már valószínűleg be tud jelentkezni), minden aktiválás után ellenőrizve az oldalt. Amelyik plugin aktiválása után újra megjelenik a WSOD, az a bűnös. Törölje azt a plugint, vagy keressen alternatívát, és jelentse a problémát a fejlesztőnek.
4. Váltson alapértelmezett témára
Ha a pluginok deaktiválása nem oldotta meg a problémát, akkor a téma lehet a hibás. Hasonlóan a pluginokhoz, az FTP-n keresztül kell alapértelmezett témára váltani.
Lépjen az FTP-n keresztül a wp-content/themes
mappába. Keresse meg az aktív téma mappáját (pl. mytheme
), és nevezze át (pl. mytheme_old
). Ezzel a WordPress egy alapértelmezett témára (pl. Twenty Twenty-Four) vált. Ha nincs alapértelmezett téma telepítve, akkor töltse le egyet a WordPress.org-ról, és töltse fel az FTP-n keresztül a themes
mappába.
Frissítse az oldalt. Ha az oldal most már betöltődik, akkor a problémát a téma okozza. Ekkor vagy meg kell próbálnia kijavítani a téma hibáját (ha Ön a fejlesztő), vagy telepítenie kell egy másik témát, és kapcsolatba lépnie az eredeti téma fejlesztőjével.
5. Cserélje ki a WordPress magfájlokat
Ritkán, de előfordul, hogy a WordPress magfájlok sérülnek. Ez frissítések vagy szerverhibák miatt történhet.
A megoldás az, hogy újra feltöltjük a WordPress legújabb verzióját.
1. Töltse le a legfrissebb WordPress verziót a wordpress.org/download oldalról.
2. Csomagolja ki a zip fájlt a számítógépén.
3. Törölje a kicsomagolt mappából a wp-content
mappát és a wp-config-sample.php
fájlt! (FONTOS! Ezeket NE írja felül, különben elveszítheti a tartalmat és a beállításokat.)
4. FTP-n keresztül töltse fel a fennmaradó fájlokat és mappákat a webhely gyökérkönyvtárába, írva felül a meglévő fájlokat.
Ez a folyamat lecseréli az összes alapvető WordPress fájlt, anélkül, hogy érintené a tartalmát vagy a beállításait.
6. Ellenőrizze az adatbázist
Ha a fentiek egyike sem segített, az adatbázis lehet a probléma forrása.
1. Jelentkezzen be a tárhely admin felületére (cPanel, Plesk), és nyissa meg a phpMyAdmin-t.
2. Válassza ki a webhelyéhez tartozó adatbázist a bal oldali menüből.
3. Jelölje be az összes táblát (alul van egy „Check All” opció).
4. Válassza ki a legördülő menüből a „Repair table” (Tábla javítása) opciót, és futtassa.
Ha ez nem segít, próbálja meg az „Optimize table” (Tábla optimalizálása) opciót is.
A WordPress-nek van egy beépített adatbázis javító funkciója is. Ehhez a wp-config.php
fájlba adja hozzá a következő sort:
define('WP_ALLOW_REPAIR', true);
Ezután látogasson el a yourdomain.com/wp-admin/maint/repair.php
URL-re. Itt talál egy opciót az adatbázis javítására és optimalizálására. Miután befejezte, ne felejtse el eltávolítani a WP_ALLOW_REPAIR
sort a wp-config.php
fájlból a biztonság érdekében.
7. Ellenőrizze a fájl jogosultságokat
A hibás fájl jogosultságok is okozhatnak problémákat.
– A mappáknak általában 755
jogosultsággal kell rendelkezniük.
– A fájloknak általában 644
jogosultsággal kell rendelkezniük.
Ezeket az FTP kliensben (jobb gomb kattintás a fájlra/mappára -> Fájlengedélyek) vagy a tárhely admin felületének fájlkezelőjében lehet beállítani. Óvatosan járjon el, és csak akkor módosítsa, ha biztos benne, hogy ez a probléma.
8. Vegye fel a kapcsolatot a tárhelyszolgáltatójával
Ha a fenti lépések egyike sem vezetett eredményre, ne habozzon felvenni a kapcsolatot a tárhelyszolgáltatójával. Gyakran ők hozzáférnek a szerveroldali hibanaplókhoz, amelyek mélyebb betekintést nyújthatnak a probléma okába. Mondja el nekik pontosan, mit próbált már meg, és mutassa meg nekik a debug.log
fájl tartalmát, ha van ilyen. Segítségükkel gyakran gyorsan orvosolható a probléma.
9. Visszaállítás biztonsági mentésből
Ha minden más kudarcot vall, és van egy friss, működő biztonsági mentése, akkor ez a végső megoldás. A biztonsági mentés visszaállítása gyakran a leggyorsabb és legbiztosabb módja annak, hogy újra működőképessé tegye az oldalt. Kövesse a biztonsági mentési megoldása (plugin vagy tárhelyszolgáltató) által javasolt lépéseket a visszaállításhoz.
Megelőzés a jövőre nézve:
Miután sikeresen elhárította a fehér halál képernyő problémát, érdemes megfontolnia néhány megelőző intézkedést, hogy elkerülje a jövőbeni incidenseket:
- Rendszeres biztonsági mentések: Ez nem is kérdés. Mindig legyen friss biztonsági mentése az oldaláról, és ellenőrizze, hogy az visszaállítható-e.
- Frissítések fokozatosan: Ne frissítse egyszerre az összes plugint és témát. Egyenként frissítsen, és minden frissítés után ellenőrizze az oldalt.
- Staging környezet: Fontosabb frissítések vagy kódmódosítások előtt használjon egy staging (fejlesztői) környezetet a teszteléshez.
- Megbízható források: Csak megbízható forrásból származó plugineket és témákat használjon.
- PHP verzió: Győződjön meg róla, hogy a tárhelyén a WordPress által támogatott, naprakész PHP verzió fut.
Összefoglalás
A WordPress fehér halál képernyő egy bosszantó, de ritkán végzetes probléma. A kulcs a módszeres megközelítés és a türelem. Az FTP hozzáférés és a hibakereső mód bekapcsolása általában elegendő információt szolgáltat a probléma azonosításához. A legtöbb esetben egy plugin konfliktus, téma hiba vagy PHP memória limit a bűnös, amelyek könnyen orvosolhatók a fent leírt lépésekkel. Ne feledje, a rendszeres biztonsági mentés az Ön legnagyobb barátja, és a legjobb védelmet nyújtja bármilyen WordPress probléma esetén.
Reméljük, hogy ez az útmutató segített újra életre kelteni webhelyét! Sok sikert a hibaelhárításhoz!
Leave a Reply