Engineering Note

WordPress kapot na een update: wat controleer je eerst?

Een praktische diagnoseroute na updates van core, plugins, theme of PHP.

Als WordPress direct na een update breekt, behoud dan de fouttoestand, maak een rollbackpunt en bepaal eerst welke laag veranderde.

Als de site nog bestellingen, formulieren of logins verwerkt, bescherm nieuwe data voordat je een oudere database terugzet.

1. Leg exact vast wat veranderde

Noteer wijzigingen in core, plugin, theme, PHP, database, cache of hosting. Als meerdere updates tegelijk draaiden, isoleer afhankelijkheden één voor één.

2. Lees de fout op de juiste laag

PHP fatal, HTTP 500, blanke pagina en kapotte layout wijzen op verschillende lagen. Server- en PHP-logs zijn meestal nuttiger dan telkens verversen.

3. Test plugin- en themegrenzen gecontroleerd

Verander één grens tegelijk en leg de uitgangssituatie vast. Veel onderdelen tegelijk uitschakelen verwijdert nuttig bewijs.

4. Behandel een PHP-upgrade als applicatiewijziging

Oude code kan fataal worden op een nieuwere PHP-versie. Begon het probleem bij PHP, test dan de stack direct tegen die wijziging.

5. Wis alleen de cache die je begrijpt

Browsercache, page cache, CDN, opcode en Redis object cache zijn verschillende systemen. Alles wissen kan het symptoom slechts verbergen.

6. Rol alleen terug wat nodig is

Voor plugin of theme kan een filerollback genoeg zijn. Een volledige database restore kan nieuwe orders, gebruikers of content overschrijven.