Xdebug in WordPress Studio

Dieser Text wurde mithilfe von KI übersetzt. Wenn du den Originaltext auf Englisch lesen möchtest, klicke hier.

Xdebug ist eine Debugging-Erweiterung für PHP, mit der du Haltepunkte setzen, Variablen untersuchen und schrittweise durch deinen Code gehen kannst. WordPress Studio enthält Xdebug-Unterstützung, die auf der WebAssembly-Version von PHP von WordPress Playground basiert.

Xdebug aktivieren

1. Wähle die Website aus, die du debuggen möchtest.
2. Navigiere zum Tab Einstellungen.
3. Klicke auf „Website bearbeiten„.
4. Aktiviere das Kontrollkästchen „Xdebug aktivieren„.
5. Klicke auf Speichern.

Die Website wird automatisch mit aktiviertem Xdebug neu gestartet.

Wichtige Einschränkungen

• Nur eine Website gleichzeitig: Xdebug kann jeweils nur für eine einzelne Website aktiviert werden. Um es für eine andere Website zu aktivieren, musst du es zunächst auf der aktuellen Website deaktivieren.
• Auswirkungen auf die Leistung: Xdebug kann die Website-Leistung verlangsamen. Deaktiviere es, wenn du nicht aktiv debuggst.

Xdebug mit deiner IDE verwenden

Sobald Xdebug für eine Website aktiviert ist, kannst du deine IDE (Code-Editor) verbinden, um WordPress-Plugins, -Themes und -Core-Code zu debuggen.

Einrichtung von Visual Studio Code

1. Installiere die PHP Debug-Erweiterung.
2. Erstelle eine .vscode/launch.json-Datei in deinem Projekt mit der folgenden Konfiguration:

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

3. Setze Haltepunkte in deinem Code.
4. Starte die Debugging-Sitzung in Visual Studio Code (Ausführen → Debuggen starten).
5. Navigiere im Browser zu deiner Website, um die Haltepunkte auszulösen.

PhpStorm-Einrichtung

1. Gehe zu Settings (Einstellungen) → PHP → Debug.
2. Überprüfe, dass der Xdebug-Port auf 9003 eingestellt ist.
3. Um das Anhalten an der ersten Zeile zu deaktivieren:
   • Deaktiviere „Force break at first line when no path mapping specified“ (Bei erster Zeile anhalten, wenn kein Pfad-Mapping angegeben ist)
   • Deaktiviere „Force break at first line when a script is outside the project“ (Bei erster Zeile anhalten, wenn ein Skript außerhalb des Projekts liegt)
4. Navigiere zu Settings (Einstellungen) -> PHP → Servers und konfiguriere das Mapping für den Server deiner Website:
   • Host: localhost:8884
   • Port: 80
   • File directory: /Users/USERNAME/Studio/SITEDIR
   • Absolute path on the server: /wordpress
5. Aktiviere „Start listening for PHP Debug Connections“ (Auf PHP-Debug-Verbindungen lauschen) in der Symbolleiste.
6. Setze Haltepunkte in deinem Code.
7. Navigiere im Browser zu deiner Website, um die Haltepunkte auszulösen.

Weitere Informationen

Weitere Informationen zur Xdebug-Integration findest du in der WordPress Playground Xdebug-Dokumentation.