Maandagochtend, negen uur. Je typt het adres van je website in en ziet… niets. Een volledig wit scherm. Geen foutmelding, geen menu, geen logo. Of je krijgt alleen de korte tekst “Er is een kritieke fout opgetreden op deze website”. Je probeert in te loggen, maar ook het dashboard blijft wit.
In de WordPress-wereld heet dit de White Screen of Death, kortweg WSOD. Het ziet er dramatisch uit, maar het is meestal goed op te lossen. In dit artikel lees je wat de White Screen of Death veroorzaakt, met welke stappen je je site weer tot leven wekt en hoe je voorkomt dat het opnieuw gebeurt.
Wat is de White Screen of Death?
Een wit scherm betekent dat WordPress tijdens het opbouwen van de pagina is vastgelopen op een fout, en die fout niet laat zien. Zie het als een stroomstoring in een gebouw: de lampen gaan uit, maar je ziet niet welke groep is doorgeslagen. Je moet de meterkast openen en de groepen een voor een controleren.
Sinds versie 5.2 is WordPress daar iets slimmer in geworden. In plaats van een volledig wit scherm zie je vaak de melding over een kritieke fout, en WordPress stuurt een e-mail naar het beheerdersadres met meer informatie en een link naar de zogeheten herstelmodus.
De meest voorkomende oorzaken
- Een plugin die niet goed werkt, vaak direct na een update of installatie.
- Een fout in het thema, bijvoorbeeld na een update of een handmatige aanpassing in de code.
- Een te oude of te nieuwe PHP-versie waar je plugins of thema niet mee overweg kunnen. Lees meer in PHP-versie updaten.
- Te weinig geheugen. Een zware pagina of plugin vraagt meer werkgeheugen dan de server toestaat.
Eerste hulp: zo los je het stap voor stap op
Voor de meeste stappen heb je toegang nodig tot de bestanden van je website. Dat kan via het bestandsbeheer in het beheerpaneel van je hostingpartij, of via FTP: een programma waarmee je de bestanden op je server bekijkt en aanpast.
1. Kijk in je mailbox
Zoek naar een e-mail van WordPress met als onderwerp iets als “Je site heeft een technisch probleem”. Daarin staat vaak welke plugin of welk thema de fout veroorzaakt, plus een link naar de herstelmodus. Via die link log je in en kun je de boosdoener uitschakelen. Zie je niets, kijk dan ook even in je spammap.
2. Schakel alle plugins in één keer uit
Geen e-mail? Ga in je bestanden naar de map wp-content en hernoem de map plugins naar bijvoorbeeld plugins_uit. Daarmee schakel je in één klap alle plugins uit. Werkt je site weer, dan lag het aan een plugin. Hernoem de map terug en zet de plugins in je dashboard een voor een weer aan, tot het wit scherm terugkomt. Dan heb je de schuldige.
3. Controleer je thema
Hernoem in de map wp-content/themes de map van je actieve thema. WordPress valt dan terug op een standaardthema, als dat nog is geïnstalleerd. Doet je site het dan weer, ook al ziet hij er anders uit, dan zit de fout in je thema.
4. Laat de fout zien
Open het bestand wp-config.php en zet de foutopsporing aan met define( 'WP_DEBUG', true );. Voeg ook define( 'WP_DEBUG_LOG', true ); en define( 'WP_DEBUG_DISPLAY', false ); toe. Dan worden fouten niet aan bezoekers getoond, maar opgeslagen in het bestand wp-content/debug.log. Daarin staat precies welk bestand op welke regel de fout veroorzaakt. Zet de foutopsporing na afloop weer uit.
5. Verhoog de geheugenlimiet
Staat er in het foutlogboek iets over “Allowed memory size exhausted”, dan heeft WordPress te weinig werkgeheugen. Je kunt de limiet verhogen door in wp-config.php de regel define( 'WP_MEMORY_LIMIT', '256M' ); toe te voegen, boven de regel die zegt dat je moet stoppen met bewerken. Werkt dat niet, dan heeft je hostingpartij een lagere grens ingesteld op de server. Vraag dan of zij die kunnen verhogen. Komt het geheugenprobleem steeds terug, dan is er vaak een zware plugin die eigenlijk vervangen moet worden.
6. Zet een back-up terug
Kom je er niet uit, dan is een recente back-up van voor het probleem je snelste weg terug. Lees in hoe vaak moet je een WordPress back-up maken hoe je ervoor zorgt dat je die altijd hebt.
Waar je op moet letten
- Niet meteen alles opnieuw installeren. Je teksten en instellingen staan veilig in de database. Een wit scherm is meestal een klein foutje in de code, geen verloren website.
- Leeg de cache. Na het oplossen kan een cachingplugin of je hostingpartij nog een oude, witte versie tonen. Leeg de cache en controleer opnieuw. Bekijk je site daarna ook in een privévenster, zodat je zeker weet dat je niet naar een opgeslagen versie in je eigen browser kijkt.
- Vastgelopen onderhoudsmelding. Zie je “Kort niet beschikbaar voor gepland onderhoud”, dan is een update halverwege blijven hangen. Verwijder het bestand
.maintenancein de hoofdmap van je website. - Voorzichtig met wp-config.php. Een verkeerd teken in dit bestand kan de hele site platleggen. Maak er altijd eerst een kopie van.
Zo voorkom je een volgend wit scherm
- Test updates eerst op een kopie van je website, zoals beschreven in WordPress veilig updaten.
- Zorg dat het beheerdersmailadres klopt, zodat je de herstelmail ook echt ontvangt.
- Laat je site monitoren, zodat je een storing als eerste ziet. Lees hoe in uptime monitoring.
Tot slot
De White Screen of Death is als een stroomstoring: eng op het moment zelf, maar met een systematische aanpak vind je de groep die is doorgeslagen. Kijk eerst in je mail, schakel plugins en thema uit, laat de fout zien en heb een back-up achter de hand. Dan is een wit scherm een vervelend kwartiertje, geen ramp.
Durf je niet in de bestanden te rommelen? Bij Webconneqt halen we je site binnen een uur uit de coma, en met goed WordPress beheer zorgen we dat het niet opnieuw gebeurt. Neem gerust contact op, dan helpen we je verder.