Xdebug is een PHP-uitbreiding waarmee ontwikkelaars fouten onderzoeken en de uitvoering van code meten. Als eigenaar van een website gebruik je het meestal niet rechtstreeks. Je kunt wel vragen welk probleem ermee wordt onderzocht en wat de uitkomst aantoont.
Een meetbestand of technische sessie is nog geen oplossing. Spreek af welke gebruikershandeling na het onderzoek weer moet werken en hoe dat wordt gecontroleerd.
Wat kan een ontwikkelaar ermee zien?
De Xdebug-documentatie beschrijft verschillende onderzoeksfuncties. Een daarvan is stap voor stap debuggen. Daarmee kan een ontwikkelaar de uitvoering volgen en gegevens onderweg bekijken.
Dat helpt bij een vraag zoals waarom een bepaalde invoer niet het verwachte resultaat geeft. De onderzoeksvraag bepaalt waar de ontwikkelaar kijkt.
De documentatie over step debugging legt de samenwerking met een ontwikkelomgeving uit. Het is dus meer dan een extra melding op een webpagina. De ontwikkelaar moet het hulpmiddel passend inrichten.
Vraag als opdrachtgever vooral om een begrijpelijke verklaring van de gevonden oorzaak, met een voorbeeld dat je kunt herkennen.
Xdebug is een PHP-extensieEen PHP-extensie voegt functies toe aan PHP die een website of toepassing nodig kan hebben.. Of die beschikbaar is, hangt af van de omgeving waarin het onderzoek plaatsvindt. De installatiedocumentatie geeft verschillende routes voor verschillende systemen.
Laat de beheerder de passende inrichting kiezen in plaats van een willekeurig installatiecommando uit een artikel over te nemen.
Begin met een reproduceerbaar probleem
Welke PHP-versie meldt jouw site?
Passieve check van headers, versie en de kop van de homepage. Geen login, geen scan.
Schrijf op welke handeling fout gaat en wat je verwachtte. Bijvoorbeeld: je vult een formulier in, verstuurt het en krijgt een lege resultaatpagina. Noteer welke invoer relevant is, zonder echte persoonsgegevens onnodig te delen.
Vraag de ontwikkelaar of diezelfde handeling op een testkopie het probleem oproept.
Een error logEen foutlog is een bestand waarin de server opschrijft welke fouten er op je website zijn voorgekomen, met tijd en plek. kan een bruikbaar beginpunt zijn. Het tijdstip van je test helpt de ontwikkelaar bij het zoeken naar de bijbehorende melding. Gebruik de Error Hub om de zichtbare fout te herkennen.
De melding is een aanwijzing; het onderzoek moet nog aantonen waarom die in jouw situatie ontstaat.
Spreek een afgebakende vraag af voordat uitgebreid wordt gemeten. Onderzoek bijvoorbeeld waarom één formulierpad faalt, niet tegelijk iedere pluginEen WordPress-plugin is een uitbreiding die je aan je WordPress-site toevoegt voor een extra functie, zoals een formulier of een webshop. en alle hostinginstellingen. Vraag na een bevinding of die de waargenomen fout verklaart.
Zo blijft een technisch onderzoek gekoppeld aan de handeling die jij nodig hebt.
Debuggen of profileren?
Bij debuggen wil je begrijpen hoe code tot een resultaat komt. Bij profileren wil je zien waar tijd of geheugen wordt gebruikt. De Xdebug-profiler verzamelt daarvoor meetgegevens die met een geschikt hulpmiddel kunnen worden bekeken.
Kies de methode die past bij de vraag, niet degene die de meeste uitvoer oplevert.
Is een pagina traag, vraag dan welke stap wordt gemeten en onder welke omstandigheden. Een meting van een beheeractie is niet automatisch een meting van de bezoekerspagina. Leg vast welke gegevensset, omgeving en handeling zijn gebruikt.
Daarmee kun je beoordelen of een tweede meting een bruikbare vergelijking is.
Laat de ontwikkelaar het verschil tussen waarneming en verklaring benoemen. Dat een functie veel tijd gebruikt, is een aanleiding voor nader onderzoek. Vraag welk gedrag gewijzigd moet worden en waarom dat de beoogde handeling helpt.
Vermijd een algemene belofte over de snelheid van de hele website op basis van één meting.
Waar voer je het onderzoek uit?
Gebruik bij voorkeur een passende testomgevingEen stagingomgeving is een afgeschermde kopie van je website waarop je updates uitprobeert voordat ze live gaan.. Spreek af welke gegevens nodig zijn en wie ze kan bekijken. Laat de beheerder aangeven hoe de onderzoeksinstellingen na afloop worden teruggezet.
Het doel is een gerichte diagnose met een duidelijk einde, niet een permanente verzameling van alle uitvoeringsgegevens.
Controleer of de testomgeving voldoende overeenkomt met de situatie waarin de fout optreedt. Vraag bij een verschil in gedrag naar de PHP-inrichting en relevante toepassingseisen. De hostergidsen helpen bij de omgeving van de website.
Ze vervangen geen controle van de omgeving waarin de ontwikkelaar de fout onderzoekt.
Wat is een bruikbare oplevering?
Vraag om de gevonden oorzaak, de toegepaste wijziging en de herhaalde gebruikershandeling. Een geslaagde proef met dezelfde relevante invoer maakt het resultaat herkenbaar. Bij snelheidsonderzoek hoort een vergelijking onder beschreven omstandigheden.
Laat ook vastleggen wat niet is onderzocht, zodat een beperkte test niet als oordeel over de complete site wordt gebruikt.
De statuspagina geeft actuele PHP-context. Xdebug is geen vervanging voor onderhoud, en de PHP Exposure Check meet geen interne uitvoering van code. Wil je PHP updaten terwijl een fout in de toepassing tegenhoudt?
Beschrijf de mislukte handeling met je verwachte resultaat. Dat is een bruikbaar begin voor gericht onderzoek.
Veelgestelde vragen
Is Xdebug hetzelfde als een foutlog?
Nee. Een log bevat meldingen. Met Xdebug kan een ontwikkelaar onder meer de uitvoering van code volgen en waarden tijdens die uitvoering bekijken.
Maakt Xdebug een trage website vanzelf sneller?
Nee. Metingen kunnen helpen een oorzaak te vinden. Daarna moet een passende wijziging worden gemaakt en onder vergelijkbare omstandigheden worden gecontroleerd.
Moet ik Xdebug zelf installeren?
Meestal is dat werk voor je ontwikkelaar of beheerder. Vraag eerst welke onderzoeksvraag het hulpmiddel moet beantwoorden en in welke omgeving het onderzoek gebeurt.