Undefined function 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-versieEen PHP-versie is het nummer van de uitgave van PHP waarop jouw website draait, zoals 8.3..

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 ontbreekt er precies

Een functie is een stukje code met een naam. Die code kan bij PHP zelf horen, bij een extra servermodule of bij je website. Dezelfde melding heeft daardoor verschillende mogelijke oorzaken.

Een servermodule kan ontbreken bij de nieuwe PHP-installatie, maar ook een bestand van de website kan niet zijn geladen.

De PHP 8.0-migratiehandleiding noemt verwijderde functies, waaronder create_function(). Zo'n functie terugzoeken in een hostinginstelling helpt niet: de applicatie moet worden aangepast. Bij een functie uit een extensie ligt de vraag anders.

Laat dan controleren of die extensie beschikbaar is in de PHP-omgeving die de website werkelijk gebruikt.

Oplossen in vijf stappen

1. Kopieer de exacte functienaam, het bestand en het regelnummer uit de eerste foutmelding. Noteer of de fout verschijnt bij inloggen, een import, een formulier of iedere pagina. Zo zoek je gericht in het onderdeel dat de functie aanroept.
2. Controleer de actieve PHP-versie voor het juiste domeinEen domeinnaam is het webadres waarmee bezoekers jouw website vinden, zoals jouwbedrijf.example. via je hostergids. Laat bij achtergrondtaken ook de commandoregelomgeving controleren. Een versie die je in een terminal ziet, bewijst niet welke versie bezoekers gebruiken.
3. Zoek met de ontwikkelaar uit wie de functie levert. Gaat het om eigen code, een plugin of een PHP-extensieEen PHP-extensie voegt functies toe aan PHP die een website of toepassing nodig kan hebben.? Controleer bij een PHP-functie de officiële migratienotities voor de oude en nieuwe versie. Gebruik de volledige naam, ook als er een naamruimte voor staat.
4. Werk de betrokken plugin of bibliotheek bij op de testkopie. Is een extensie nodig, laat de hoster die voor de juiste PHP-versie activeren. Is de functie verwijderd, laat de code vervangen door een ondersteunde aanpak. Maak geen lege vervangfunctie alleen om de fout te verbergen.
5. Herhaal de oorspronkelijke handeling en vergelijk het nieuwe log met je notitie. Controleer ook of de herstelde functie het verwachte resultaat oplevert. Een import zonder foutmelding maar zonder geïmporteerde records is nog geen geslaagd herstel.

Een nuttig verschil

Staat er curl_init in de melding, dan is dit een ander onderzoek dan een certificaatfout tijdens een cURL-verbinding. In het eerste geval ontbreekt de functie op het moment van aanroepen. In het tweede geval is de verbinding al geprobeerd.

Gebruik het verwante certificaatartikel pas als de melding daadwerkelijk over de verbinding gaat.

Wanneer je dit beter laat doen

Laat een ontwikkelaar helpen wanneer de functienaam uit maatwerk komt, wanneer meerdere plugins betrokken zijn of wanneer een koppeling betalingen verwerkt. Gebruik de hulpknop naar het hulpformulier hieronder en geef de fouttekst, versiewissel en getroffen handeling door. Je hoeft geen servertoegang of wachtwoord in je eerste bericht te zetten.

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.