PHP fouten debuggen en oplossen: complete aanpak

PHP fouten lijken vaak cryptisch, maar bijna elke foutmelding wijst direct naar de oorzaak als je weet waar je moet kijken. Zet eerst error reporting aan om fouten zichtbaar te maken, bekijk daarna het juiste logbestand en pak de meest voorkomende foutsoorten stap voor stap aan. Met de juiste instellingen in PHP en Plesk los je de meeste problemen binnen enkele minuten op.

Soorten PHP fouten herkennen

PHP kent verschillende foutniveaus, en het type fout bepaalt hoe dringend je actie moet ondernemen.

• Parse error: een syntaxfout, bijvoorbeeld een vergeten puntkomma of accolade. De site werkt meestal helemaal niet meer.
• Fatal error: een functie of klasse bestaat niet, of een bestand kan niet worden geladen. Vaak de oorzaak van een witte pagina.
• Warning: iets gaat mis, maar het script draait door. Denk aan een ontbrekende array-waarde.
• Notice/Deprecated: minder ernstig, maar wijst vaak op verouderde code die bij een nieuwere PHP-versie problemen gaat geven.

Een melding als Fatal error: Uncaught Error: Call to undefined function betekent letterlijk dat PHP een functie niet kent, bijvoorbeeld omdat een plugin of module ontbreekt.

Error reporting en logging instellen

Om fouten te kunnen oplossen, moet je ze eerst kunnen zien. Standaard staat weergave van fouten op een live site vaak uit, en dat is terecht: je wilt geen foutmeldingen met servicepaden aan bezoekers tonen. In plaats daarvan log je fouten naar een bestand.

Zet in je php.ini of via een .user.ini het volgende:

• display_errors = Off (op productie)
• log_errors = On
• error_reporting = E_ALL
• error_log = /pad/naar/php_errors.log

In Plesk vind je per domein eenvoudig de PHP-instellingen en het bijbehorende foutenlog onder de sectie ‘PHP-instellingen’ en ‘Logbestanden’, zodat je niet zelf in configuratiebestanden hoeft te zoeken.

Veelvoorkomende fouten oplossen

De meeste PHP fouten vallen in een beperkt aantal categorieën:

• Undefined function/class: controleer of de juiste PHP-extensie is ingeschakeld, of dat een bestand met een require/include niet is geladen.
• Undefined variable/array key: controleer of een variabele wel bestaat voordat je hem gebruikt, bijvoorbeeld met isset().
• Memory limit exceeded: verhoog de memory_limit in php.ini, maar zoek ook uit waarom een script zoveel geheugen nodig heeft.
• Maximum execution time exceeded: een script duurt te lang, vaak door een zware query of externe aanroep zonder timeout.
• Class not found: meestal een ontbrekende autoloader, bijvoorbeeld na het vergeten van composer install.

Na een update van je website of een PHP-versiewisseling kunnen opeens nieuwe foutmeldingen verschijnen, omdat verouderde code niet meer compatibel is. Test daarom na elke PHP-versiewisseling de belangrijkste pagina’s van je site.

Stappenplan bij een witte pagina of 500-fout

Een witte pagina (‘white screen of death’) of een interne serverfout geeft vaak geen directe foutmelding op het scherm. Volg dit stappenplan om snel de oorzaak te vinden.

Voor e-mailgerelateerde PHP-scripts, zoals contactformulieren die mail versturen, is het ook slim om te controleren of je zakelijke e-mail correct is geconfigureerd, zodat foutmeldingen niet per ongeluk in een spamfilter verdwijnen. Twijfel je of je hosting goed is ingericht voor foutopsporing, bekijk dan de mogelijkheden van webhosting met Plesk en logtoegang. Loop je vast, dan vind je meer uitleg in de kennisbank.