De "white screen of death" (WSOD) is een van de meest frustrerende WordPress problemen. Je website toont alleen een wit scherm zonder foutmelding, waardoor je niet weet wat er mis is. In dit artikel helpen we je stap voor stap de oorzaak te vinden en op te lossen.

Wat veroorzaakt de white screen of death?

De WSOD ontstaat wanneer WordPress een fatale PHP-fout tegenkomt maar geen foutmelding kan tonen. De meest voorkomende oorzaken zijn:

  • Plugin conflicten - Een plugin die niet compatibel is met je WordPress versie of andere plugins
  • Theme problemen - Een fout in je actieve theme of child theme
  • PHP geheugen limiet - WordPress heeft onvoldoende geheugen om te functioneren
  • Corrupte bestanden - Beschadigde WordPress core bestanden
  • PHP versie incompatibiliteit - Je site draait op een te oude of te nieuwe PHP versie

Stap 1: WP_DEBUG inschakelen

De eerste stap is het zichtbaar maken van PHP fouten. Dit doe je via FTP of de bestandsbeheerder in DirectAdmin.

Via FTP verbinden

Maak eerst een FTP verbinding met je website. Zoek het bestand wp-config.php in de hoofdmap.

WP_DEBUG activeren

Open wp-config.php en zoek de regel:

Verander dit naar:

Sla het bestand op en laad je website opnieuw. Nu zou je een PHP foutmelding moeten zien die aangeeft wat het probleem is.

Belangrijk: Schakel WP_DEBUG weer uit na het oplossen van het probleem, want foutmeldingen bevatten gevoelige informatie.

Stap 2: Plugins deactiveren via FTP

Als je niet meer kunt inloggen op WordPress, kun je plugins handmatig deactiveren:

  1. Verbind via FTP met je website
  2. Navigeer naar wp-content/plugins/
  3. Hernoem de map "plugins" naar "plugins_disabled"
  4. Laad je website - werkt het nu? Dan ligt het aan een plugin
  5. Hernoem de map terug naar "plugins"
  6. Hernoem individuele plugin mappen om de boosdoener te vinden

Systeematisch testen

  1. Hernoem plugin mappen een voor een (bijv. "akismet" naar "akismet_disabled")
  2. Test je website na elke wijziging
  3. De plugin die het probleem veroorzaakt is degene waarna je site weer werkt
  4. Verwijder of update die plugin

Stap 3: Theme controleren

Als plugins niet het probleem zijn, controleer je theme:

  1. Via FTP, ga naar wp-content/themes/
  2. Hernoem je actieve theme map (bijv. "twentytwentyfour_disabled")
  3. WordPress activeert automatisch een standaard theme
  4. Werkt de site nu? Installeer een ander theme of fix je huidige theme

Tip: Houd altijd een standaard WordPress theme geinstalleerd voor dit soort situaties.

Stap 4: PHP memory limit verhogen

Een te lage memory limit is een veelvoorkomende oorzaak. Er zijn meerdere manieren om dit te verhogen.

Via wp-config.php

Voeg deze regel toe aan wp-config.php, voor de regel "That is all, stop editing!":

Via .htaccess

Voeg toe aan je .htaccess bestand in de hoofdmap:

Via DirectAdmin

De beste en permanente oplossing is via DirectAdmin:

  1. Log in op DirectAdmin
  2. Ga naar "Select PHP version" of "PHP Settings"
  3. Zoek "memory_limit" en verhoog naar 256M of hoger
  4. Sla de instellingen op

Voor meer details over PHP limieten, zie ons artikel over PHP geheugen en limieten verhogen.

Stap 5: WordPress core bestanden herstellen

Soms raken WordPress bestanden corrupt. Zo herstel je ze:

  1. Download een verse kopie van WordPress via wordpress.org
  2. Via FTP, upload alleen de mappen wp-admin en wp-includes
  3. Upload ook losse bestanden in de hoofdmap (behalve wp-config.php!)
  4. Let op: raak wp-content NIET aan, daar staan je uploads en themes

Stap 6: PHP versie controleren

Een incompatibele PHP versie kan de WSOD veroorzaken:

  1. Log in op DirectAdmin
  2. Ga naar "Select PHP version"
  3. Controleer welke PHP versie actief is
  4. WordPress 6.x vereist minimaal PHP 7.4, aanbevolen is PHP 8.1 of 8.2
  5. Sommige oudere plugins werken niet met PHP 8.x - probeer PHP 7.4

Stap 7: Error logs controleren

Als WP_DEBUG geen output geeft, check de server error logs:

  1. In DirectAdmin, ga naar "Error Log"
  2. Bekijk de laatste regels voor PHP fouten
  3. De foutmelding wijst je vaak direct naar het probleem

Bij Theory7 hosting heb je altijd toegang tot error logs via DirectAdmin.

Veelvoorkomende foutmeldingen

"Allowed memory size exhausted"

Verhoog de PHP memory limit zoals beschreven in stap 4.

"Maximum execution time exceeded"

Verhoog de max_execution_time in DirectAdmin PHP Settings naar 300 seconden.

"Parse error: syntax error"

Er zit een typfout in een PHP bestand. De foutmelding toont exact welk bestand en welke regel.

"Fatal error: Call to undefined function"

Een plugin of theme gebruikt een functie die niet bestaat in je PHP versie. Update de plugin of wissel van PHP versie.

Preventieve maatregelen

Voorkom toekomstige WSOD problemen:

  • Maak regelmatig backups - Gebruik een backup plugin of de backup functie in DirectAdmin
  • Test updates op staging - Update plugins en themes eerst op een staging omgeving
  • Houd alles up-to-date - Verouderde plugins zijn de grootste oorzaak van problemen
  • Gebruik kwaliteitsplugins - Kies plugins met goede reviews en regelmatige updates

Hulp nodig?

Als je er niet uitkomt, neem contact op met de Theory7 support. We helpen je graag verder met het oplossen van WordPress problemen.