Wit scherm in PHP of WordPress: oorzaak en oplossing

Je website toont een lege, witte pagina, dus bezoekers en klanten zien niets. Brengt je site aanvragen of bestellingen op, dan is dit het waard om vandaag nog aan te pakken. De reden staat meestal in een logbestand, en met de stappen hieronder krijg je de pagina vaak terug zonder speciale hulpmiddelen.

Een wit scherm, in het Engels de 'white screen of death', betekent meestal dat PHPPHP is de programmeertaal waarmee veel websites, zoals WordPress-sites, hun pagina's maken op het moment dat een bezoeker erom vraagt. is gestopt door een fatale fout en dat de foutmelding niet op het scherm komt. Je ziet dan een lege pagina zonder tekst, vaak op de hele site, soms alleen in wp-admin.

Wat een wit scherm betekent

PHP toont fouten alleen als de server dat toestaat. Op de meeste productiesites staat het tonen van fouten uit, en dat is goed. Daardoor blijft het scherm leeg terwijl de fout wel bestaat. Een wit scherm is dus geen oorzaak, maar een symptoom.

Veelvoorkomende oorzaken

Vaak ligt het aan een pluginEen WordPress-plugin is een uitbreiding die je aan je WordPress-site toevoegt voor een extra functie, zoals een formulier of een webshop. of themaEen WordPress-thema is het ontwerp van je WordPress-site: het bepaalt hoe pagina's eruitzien en hoe ze zijn opgebouwd. met een fout, een geheugenlimiet die te laag is, een bestand dat half is geüpload of een PHP-versieEen PHP-versie is het nummer van de uitgave van PHP waarop jouw website draait, zoals 8.3. waar de code niet tegen kan. Ook een tikfout in een bestand dat je net hebt aangepast kan het veroorzaken.

Zo controleer je het veilig

Maak eerst een back-upEen back-up is een kopie van je hele website, apart bewaard, zodat je hem kunt terugzetten als er iets misgaat.. Laat daarna fouten naar een logbestand schrijven in plaats van naar het scherm. In WordPressWordPress is een programma waarmee je een website maakt en beheert zonder te hoeven programmeren. zet je in wp-config.phpWP_DEBUG is een schakelaar in WordPress die foutmeldingen zichtbaar maakt, zodat je kunt zien waarom je site iets raars doet. WP_DEBUG en WP_DEBUG_LOG aan en WP_DEBUG_DISPLAY uit. Fouten komen dan in wp-content/debug.logEen foutlog is een bestand waarin de server opschrijft welke fouten er op je website zijn voorgekomen, met tijd en plek. terecht en bezoekers zien niets. Dat bestand is vaak via het web bereikbaar; verwijder het als je klaar bent. Je hostingpaneelEen hostingpaneel, zoals cPanel of Plesk, is de beheerpagina van je hosting, waar je domeinen, e-mail en PHP-versie instelt. heeft vaak ook een foutlog. Zet de debug-opties na afloop weer uit en deel dat logbestand niet openbaar.

Wat je zelf kunt proberen

Lees de laatste regels van het logbestand: daar staat meestal het bestand en de regel van de fout. Wijst dat naar een plugin, hernoem dan de map van die plugin via FTP of het bestandsbeheer. Wijst het naar het thema, schakel dan over op een standaardthema door de themamap te hernoemen. Staat er een melding over geheugen, lees dan het artikel over een uitgeput geheugen. Controleer ten slotte of je net een bestand hebt aangepast en draai die wijziging terug.

Wanneer de PHP-versie de oorzaak kan zijn

Is het scherm wit geworden na een wissel van PHP-versie, dan gebruikt een plugin of thema vaak functies die in de nieuwe versie anders werken of zijn verwijderd. Op de pagina over ondersteunde PHP-versies van deze site lees je welke versies het PHP-project nog bijwerkt.

Zo voorkom je een volgend wit scherm

Pas geen bestanden aan op de live site zonder een kopie van het origineel. Werk plugins en thema's één voor één bij en controleer na elke update zowel de voorkant als wp-admin. Test een nieuwe PHP-versie eerst op een stagingomgevingEen stagingomgeving is een afgeschermde kopie van je website waarop je updates uitprobeert voordat ze live gaan.. Zorg dat je via je hostingpaneel of SFTP bij je bestanden kunt, ook als je niet in WordPress kunt inloggen. Dan kun je bij een storing snel een plugin uitschakelen.

Hulp inschakelen

Blijft het scherm wit of wil je niet aan live bestanden zitten, dan is hulp verstandig. Bij Website Without PHP, een dienst van Monkey Vision B.V., antwoordt een mens binnen 1 werkdag. Een spoedherstel start vanaf € 375, exclusief btw.