White Screen of Death in WordPress oplossen

De WordPress White Screen of Death (WSOD) is een lege witte pagina die in plaats van je site of je wp-admin verschijnt. Je ziet dan geen foutmelding: door een fatale PHP-fout stopt WordPress voordat er iets op het scherm komt. In dit artikel lees je wat de WSOD veroorzaakt en hoe je stap voor stap de oorzaak vindt en oplost.

Wat is de White Screen of Death

WordPress is een PHP-applicatie. Loopt een script bij het opbouwen van een pagina vast op een fatal error, dan stopt PHP onmiddellijk en krijgt je browser een lege pagina. Je ziet een wit scherm zonder foutmelding, header of menu. De foutmelding is er wel, maar WordPress toont hem om veiligheidsredenen standaard niet.

De WordPress white screen of death heeft in de praktijk vrijwel altijd een van vier oorzaken: een plugin-conflict, een thema met een fout, een PHP-versie waar de site niet meer mee werkt, of een memory_limit die op is. Met de stappen hieronder vind je de oorzaak.

Stap 1: zet WP_DEBUG aan

Open wp-config.php via Plesk file-manager of via een FTP-verbinding als je geen toegang meer hebt tot je wp-admin. Zoek de regel die debug-mode regelt en zet de waarden op true:

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

Met deze drie regels schrijft WordPress alle PHP-fouten weg naar wp-content/debug.log, zonder ze aan bezoekers te tonen. Laad daarna de pagina opnieuw die het witte scherm geeft. WordPress loopt dan weer vast en schrijft de precieze fout naar het logbestand.

Stap 2: lees de error-log

Naast het WordPress-debug-log heeft de webserver zelf ook een error-log. Die staat los van WordPress en bevat ook fouten die optreden voordat WordPress geladen is. Bij onze WordPress hosting open je deze logs met 1 klik in Plesk.

Log in op het controlepaneel

Je vindt het controlepaneel door :8443 achter jouw domeinnaam te typen. Bijvoorbeeld: www.jouw-website.nl:8443.

Ben je je gebruikersnaam of wachtwoord vergeten, dan vind je op deze pagina instructies om je wachtwoord op te vragen.

• Open Plesk en klik op het domein van jouw-website.nl.
• Klik op Logs voor een live-weergave, of open Files en navigeer naar /logs/error_log voor het ruwe bestand.

Zoek in de log naar regels met PHP Fatal error of Uncaught Error. Deze regels bevatten meestal het bestandspad van de plugin of het thema dat de fout veroorzaakt. Een pad als wp-content/plugins/voorbeeld-plugin/init.php wijst dan direct de boosdoener aan.

Stap 3: plugin-conflict opsporen

Wijst de error-log een plugin aan, of weet je niet welke plugin de oorzaak is, dan deactiveer je ze allemaal in één keer. Dat kan zonder wp-admin via de file-manager.

1. Open Plesk en ga naar Files.
2. Navigeer naar httpdocs/wp-content/ (of public_html/wp-content/ als je al voor 2021 klant was).
3. Hernoem de map plugins naar plugins-uit.
4. Laad jouw-website.nl opnieuw. Werkt de site nu, dan zit de oorzaak in een plugin.
5. Ga naar wp-admin, Plugins. WordPress meldt dat de plugins ontbreken en zet ze uit. Hernoem de map daarna terug naar plugins. De plugins staan dan uit totdat je ze handmatig aanzet.
6. Log in op wp-admin en activeer de plugins één voor één. Ververs na elke activatie de site. Zodra het witte scherm terugkomt, weet je welke plugin het probleem veroorzaakt.

Update de schuldige plugin naar de nieuwste versie. Werkt dat niet, kijk dan in de changelog van de plugin of hij werkt met je WordPress- en PHP-versie, en zoek zo nodig een andere plugin.

Stap 4: thema als oorzaak

Geeft de site nog steeds een wit scherm met alle plugins gedeactiveerd, dan zit de fout vrijwel zeker in het actieve thema. Schakel tijdelijk over op een standaard WordPress-thema zoals Twenty Twenty-Five om dat te bevestigen.

1. Open in Plesk de file-manager en ga naar httpdocs/wp-content/themes/ (of public_html/wp-content/themes/ als je al voor 2021 klant was).
2. Controleer dat er een map twentytwentyfive aanwezig is. Zo niet, download het thema via wordpress.org en upload de map naar deze locatie.
3. Hernoem de map van je huidige thema, bijvoorbeeld van mijn-theme naar mijn-theme-uit.
4. Open in wp-admin Weergave → Thema’s. WordPress ziet dat het actieve thema ontbreekt en schakelt over op het standaardthema.
5. Laad de site opnieuw. Werkt jouw-website.nl nu, dan ligt het probleem in het thema.

Een veelvoorkomende oorzaak in thema’s is een aanpassing in functions.php die niet meer werkt op een nieuwere PHP-versie. Heeft een ontwikkelaar onlangs iets aangepast, laat die wijziging dan nakijken. Kijk daarbij ook naar je PHP-versie, want oudere thema’s werken vaak niet meer met PHP 8.