Miért töltődik be a weboldalam üres fehér oldalként?

Megnyitod az oldaladat, és a kezdőlap helyett egy teljesen üres fehér oldalt kapsz. Se szöveg, se hibaüzenet, semmi. Idegőrlő élmény, főleg ha az oldalad ügyfeleket vagy eladásokat hoz. A jó hír: ez a „halál fehér képernyője" (WSOD) nem a semmiből jelenik meg, és szinte mindig van egy egyértelmű technikai oka, amit ki lehet nyomozni.

A legtöbb esetben a fehér oldal azt jelenti, hogy a szerver egy végzetes PHP-hibába ütközött, és leállt, mielőtt bármilyen tartalmat küldött volna a böngészőnek. A szokásos gyanúsított egy bővítmény, egy sablon vagy egy rosszul sikerült frissítés. Ebben az útmutatóban lépésről lépésre — felesleges szakzsargon nélkül — végigvezetlek azon, hogyan azonosítsd az okot, és hozd vissza az oldaladat, még akkor is, ha nem vagy technikai beállítottságú.

Mit is jelent valójában a fehér oldal

Egy WordPress oldal (vagy bármely PHP-alapú oldal) így működik: a szerver lefuttatja a kódot, felépíti az oldalt, és elküldi a böngészőnek. Amikor egy kódrészlet végzetes hibát dob — hiányzó függvény, összeférhetetlenség, kimerült memória —, a végrehajtás hirtelen leáll. Ha a hibák megjelenítése ki van kapcsolva (ahogy egy nyilvános oldalon lennie is kell), nem látod a hibaüzenetet, csak az eredményt: egy üres, fehér oldalt.

A fehér oldal tehát nem „betegség" — hanem tünet. Mögötte valahol ott van egy nagyon konkrét hibaüzenet; nekünk csak felszínre kell hoznunk azt. Az ok gyakran közvetlenül egy művelet után jelenik meg: telepítettél egy bővítményt, rákattintottál a „Frissítés" gombra, szerkesztettél egy sablont. Az első, amit javasolnék: emlékezz vissza pontosan, mi történt közvetlenül előtte.

A leggyakoribb okok

A gyakorlatban szinte minden fehér képernyő néhány gyakori forrásból ered:

• Bővítmény-ütközés vagy egy rosszul megírt bővítmény — a leggyakoribb ok. Egy frissített bővítmény összeférhetetlenné válik egy másikkal vagy a PHP-verzióddal.
• Hibás sablon — különösen egy frissítés vagy a fájljainak közvetlen szerkesztése után.
• Kimerült PHP-memórialimit — az oldal több memóriát kér, mint amennyit a szerver megenged, és összeomlik.
• Megszakadt frissítés — a WordPress, egy sablon vagy egy bővítmény csak félig frissült (megszakadt kapcsolat, időtúllépés).
• Összeférhetetlen PHP-verzió — a tárhelyszolgáltató új PHP-verzióra váltott, és egy régi bővítmény nem támogatja azt.

Egy hasznos részlet: figyeld meg, hol jelenik meg a fehér. Csak a nyilvános oldalon? Csak a /wp-admin felületen? Mindenhol? Ez sokat leszűkíti a keresést.

1. lépés: tedd láthatóvá a hibákat

Hogy ne kelljen találgatnod, mutassa meg a WordPress, pontosan melyik hiba történt. FTP-n vagy a tárhelyed File Manager felületén keresztül nyisd meg a wp-config.php fájlt, és keresd meg a WP_DEBUG sort. Állítsd be:

• define('WP_DEBUG', true);
• define('WP_DEBUG_LOG', true);
• define('WP_DEBUG_DISPLAY', false);

A bekapcsolt WP_DEBUG_LOG mellett a hibák egy debug.log fájlba kerülnek a /wp-content/ mappában. Töltsd újra a fehér oldalt, majd nyisd meg azt a fájlt. Az utolsó sorok szinte mindig megnevezik a tettest: a fájlt és a bővítményt vagy sablont, amely a végzetes hibát dobta.

Fontos: miután kijavítottad, állítsd vissza a WP_DEBUG-ot false értékre. Nem szeretnéd, hogy a hibák láthatóak legyenek a nagyközönség számára egy élő oldalon — ez biztonsági kérdés is.

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

Ha bővítményre gyanakszol (ez a legvalószínűbb forgatókönyv), de nem tudsz belépni a /wp-admin felületre, tiltsd le őket a vezérlőpult nélkül:

• Lépj be a /wp-content/ mappába FTP-n vagy File Manageren keresztül.
• Nevezd át a plugins mappát plugins-off névre. A WordPress automatikusan deaktivál minden bővítményt.
• Ellenőrizd az oldalt. Ha visszatért, egy bővítmény volt az ok.
• Nevezd vissza a mappát plugins névre, majd aktiváld újra a bővítményeket egyesével, mindegyik után ellenőrizve. Amelyik visszahozza a fehér képernyőt, az a tettes.

Ha nem a bővítmények a probléma, teszteld a sablont: a /wp-content/themes/ mappában nevezd át az aktív sablonod mappáját. A WordPress egy alapértelmezett sablonra vált vissza (Twenty Twenty-valami). Ha az oldal megjelenik, a probléma a sablonodban van.

3. lépés: PHP-memória és befejezetlen frissítések

Ha a debug.log valami olyasmit mutat, hogy „Allowed memory size exhausted", az oldalnak elfogyott a memóriája. Emeld meg a wp-config.php fájlban, a „That's all, stop editing" sor előtt:

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

Ha ez még mindig nem elég, a tárhelyszolgáltatód megemelheti a tényleges PHP-limitet a vezérlőpultról. A kisebb tárhelyeken a limit gyakran szűkös.

Ha a fehér közvetlenül egy megszakadt frissítés után jelent meg, előfordulhat, hogy egy .maintenance fájl beragadt az oldal gyökérkönyvtárában — töröld azt. És ha a tárhelyszolgáltatód éppen most változtatta meg a PHP-verziót, kérd meg őket (vagy váltsd át a panelen), és próbálj ki egy stabil verziót, amelyet a sablonod és a bővítményeid támogatnak.

Hogyan előzheted meg — és mikor éri meg segítséget kérni

A megelőzés olcsóbb, mint a pánik. Néhány egyszerű szabály:

• Készíts biztonsági mentést minden frissítés előtt — automatikusan, nem pedig „amikor eszembe jut".
• Teszteld a frissítéseket egy staging (próba-) oldalon, ne közvetlenül az élőn.
• Tarts kevés bővítményt, és komoly forrásból; minden extra bővítmény extra kockázat.
• Ne szerkeszd közvetlenül a sablonfájlokat — használj gyermeksablont (child theme), vagy kérj meg valakit, aki ért hozzá.

Ha kipróbáltad a fenti lépéseket, és még mindig fehéret látsz, vagy egyszerűen nem akarsz FTP-ben matatni azon az oldalon, amelytől függsz, ne erőltesd tovább, amíg még többet el nem rontasz. Az MPO Web Studiónál távolról építünk és karbantartunk oldalakat, biztonsági mentésekkel és monitorozással együtt — és gyorsan, távolról tudjuk diagnosztizálni a fehér képernyőt. Egy rövid WhatsApp-üzenet, amelyben elmondod, mi történt közvetlenül a hiba előtt, gyakran elég ahhoz, hogy nekilássunk.