Class not found na een PHP-update oplossen

Voor je begint

Bewaar de volledige foutmelding en het tijdstip in een privénotitie. Noteer welke pagina of handeling de fout oproept en wat er vlak daarvoor veranderde. Een screenshot van alleen een lege pagina is minder bruikbaar dan de eerste foutregel uit het log.

Deel geen wachtwoorden, klantgegevens of volledige serverpaden in een openbaar forum.

Maak een back-upEen back-up is een kopie van je hele website, apart bewaard, zodat je hem kunt terugzetten als er iets misgaat. van bestanden en database voordat je iets wijzigt. Controleer ook hoe je die terugzet. Werk bij voorkeur op een afgeschermde testkopie met dezelfde PHP-versie.

Schakel daar echte betalingen en uitgaande klantmails uit. Verander één onderdeel per proef en schrijf op wat je hebt aangepast, zodat een mislukte poging eenvoudig terug te draaien is.

Wat een class en autoloading betekenen

Een class bundelt code voor een bepaald soort taak of object. Websites laden zulke code vaak pas wanneer die nodig is. Dat heet autoloading.

PHP geeft geregistreerde autoloaders de kans om een ontbrekende class te laden. Als de class daarna nog niet beschikbaar is, kan de uitvoering niet op die manier verder.

De PHP-handleiding vermeldt dat de oude functie __autoload() vanaf PHP 8.0 is verwijderd. Dat is één concrete upgradeoorzaak. Andere mogelijke onderzoeksrichtingen zijn een onvolledige upload, een fout in een naamruimte of een ontbrekend pakket.

Geen daarvan staat vast op basis van de korte melding alleen.

Oplossen in vijf stappen

1. Bewaar de volledige classnaam inclusief naamruimte, het bestand en de eerste foutregel. Noteer welke actie de fout oproept. Controleer of vlak daarvoor een pakketinstallatie of upload is afgebroken. Dat geeft een andere aanwijzing dan een wijziging van uitsluitend de PHP-versie.
2. Laat vaststellen wie de class levert. Is dat een pluginEen WordPress-plugin is een uitbreiding die je aan je WordPress-site toevoegt voor een extra functie, zoals een formulier of een webshop., een meegeleverde bibliotheek of een PHP-extensieEen PHP-extensie voegt functies toe aan PHP die een website of toepassing nodig kan hebben.? Vergelijk de aanwezige bestanden met de bedoelde release. Kopieer niet zomaar een gelijknamig bestand uit een andere website; de inhoud kan bij andere versies horen.
3. Controleer met de ontwikkelaar hoe de autoloader wordt geladen. Bij oude code moet mogelijk __autoload() worden vervangen door een ondersteunde registratie. Bij pakketbeheer moet de vastgelegde pakketset volledig aanwezig zijn. Laat bij iedere stap het concrete bewijs noteren in plaats van alleen opnieuw proberen.
4. Herstel de passende release op een testkopie. Laat zo nodig de autoloadbestanden opnieuw opbouwen volgens de bestaande projectinstructies. Verwijder de lockfile niet en voeg geen lege class toe om de foutmelding te laten verdwijnen. De aanroepende code verwacht echt gedrag van die class.
5. Test de route die de class gebruikt, inclusief het resultaat. Controleer daarna een tweede route die van hetzelfde pakket afhangt. Bekijk nieuwe logregels en leg vast welke bestandsset en PHP-versie bij de werkende combinatie horen. Dat maakt een volgende uitrol controleerbaar.

Waarom de volgorde ertoe doet

Een ontbrekende class kan een gevolg zijn van een eerder mislukte installatie. Eerst de fout in die installatie herstellen kan zinvoller zijn dan de aanroepende plugin wijzigen. Kijk daarom naar de eerste fout in de tijdlijn.

Een later foutbericht kan beschrijven wat daardoor ontbreekt, zonder de oorspronkelijke oorzaak te noemen.

Wanneer je dit beter laat doen

Gebruik het hulpformulier hieronder als pakketbeheer, namespaces of autoloaders onbekend terrein zijn, of als een live update half is uitgevoerd. Deel de classnaam en de relevante versiegegevens privé. Vraag de ontwikkelaar om de herkomst van de class aan te tonen en de benodigde functie te testen.

Een verdwenen foutmelding zonder werkende functie is niet genoeg.

Controle na herstel

Herhaal eerst precies de handeling die misging. Controleer daarna inloggen, een formulier versturen en de belangrijkste route van jouw website. Gebruik voor een winkel een testbestelling zonder echte afschrijving.

Bekijk het log op nieuwe meldingen met een recent tijdstip. Alleen een werkende homepage bewijst nog niet dat het hele probleem weg is.

Bewaar de gebruikte versies, de uitgevoerde wijziging en het resultaat bij je onderhoudsnotities. Spreek af wie de eerstvolgende update controleert. Stop als dezelfde fout terugkomt terwijl de veronderstelde oorzaak al is opgelost.

Dat is een reden om de diagnose opnieuw te bekijken, geen reden om steeds meer instellingen tegelijk te veranderen.