Xdebug in WordPress Studio

Deze tekst is vertaald met AI. Als je de oorspronkelijke tekst in het Engels wilt bekijken, klik dan hier.

Xdebug is een debugging-extensie voor PHP waarmee je breakpoints kunt instellen, variabelen kunt inspecteren en stap voor stap door je code kunt lopen. WordPress Studio bevat ondersteuning voor Xdebug, mogelijk gemaakt door de WebAssembly-versie van PHP van WordPress Playground.

Xdebug inschakelen

1. Selecteer de site die je wilt debuggen.
2. Ga naar het tabblad Instellingen.
3. Klik op ‘Site bewerken‘.
4. Vink het selectievakje ‘Xdebug inschakelen‘ aan.
5. Klik op Opslaan.

De site wordt automatisch opnieuw opgestart met Xdebug ingeschakeld.

Belangrijke beperkingen

• Slechts één site tegelijk: Xdebug kan maar voor één site tegelijk worden ingeschakeld. Om het voor een andere site in te schakelen, moet je het eerst uitschakelen op de huidige site.
• Invloed op prestaties: Xdebug kan de prestaties van de site vertragen. Schakel het uit wanneer je niet actief aan het debuggen bent.

Xdebug gebruiken met je IDE

Zodra Xdebug voor een site is ingeschakeld, kun je je IDE (code-editor) verbinden om WordPress-plugins, thema’s en core-code te debuggen.

Visual Studio Code instellen

1. Installeer de PHP Debug-extensie.
2. Maak een .vscode/launch.json -bestand in je project met de volgende configuratie:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003,
      "pathMappings": {
        "/wordpress": "${workspaceFolder}"
      }
    }
  ]
}

3. Stel breakpoints in je code in.
4. Start de debug-sessie in Visual Studio Code (Run (Uitvoeren) → Start Debugging (Debuggen starten)).
5. Ga naar je site in de browser om de breakpoints te activeren.

PhpStorm instellen

1. Ga naar Settings (Instellingen) → PHP → Debug (Debuggen).
2. Controleer of de Xdebug-poort is ingesteld op 9003.
3. Stoppen met onderbreken op de eerste regel:
   • Schakel “Force break at first line when no path mapping specified” (Onderbreking afdwingen op de eerste regel wanneer er geen padtoewijzing is opgegeven) uit
   • Schakel “Force break at first line when a script is outside the project” (Onderbreking afdwingen op de eerste regel wanneer een script zich buiten het project bevindt) uit
4. Ga naar Settings (Instellingen) -> PHP → Servers en configureer de toewijzing voor de server van je site:
   • Host: localhost:8884
   • Port (Poort): 80
   • File directory (Bestandsmap): /Users/USERNAME/Studio/SITEDIR
   • Absolute path on the server (Absoluut pad op de server): /wordpress
5. Schakel “Start listening for PHP Debug Connections (Luisteren naar PHP-debugverbindingen starten)” in via de werkbalk.
6. Stel breakpoints in je code in.
7. Ga naar je site in de browser om de breakpoints te activeren.

Meer informatie

Bekijk voor aanvullende informatie over Xdebug-integratie de WordPress Playground Xdebug-documentatie.