Zurück zum Blog

So richten Sie Xdebug mit DDEV in VSCode in 4 Schritten ein

2023-08-142 Min. Lesezeit

So richten Sie Xdebug mit DDEV in VSCode ein: Verbessern Sie Ihre Coding- und Debugging-Erfahrung in diesem beliebten Editor in nur vier einfachen Schritten, wie in diesem Beitrag beschrieben.

Xdebug ist ein Debugging- und Profiling-Tool für PHP. Es bietet Stack-Traces, Variableninspektion und Breakpoints sowie Code-Coverage und Performance-Profiling zur Optimierung von PHP-Anwendungen.

Debugging ist der Prozess der Identifizierung, Diagnose und Korrektur von Fehlern oder Bugs in Software. Diese Fehler können in Form von falschem Code, logischen Fehlern oder unerwünschten Verhaltensweisen auftreten, die verhindern, dass die Software wie beabsichtigt funktioniert.

1. Voraussetzungen installieren:

Stellen Sie sicher, dass Sie die folgenden Tools installiert haben:

2. DDEV für Xdebug konfigurieren:

DDEV wird standardmäßig mit Xdebug vorkonfiguriert geliefert. Sie müssen es nur aktivieren:

  1. Navigieren Sie zu Ihrem DDEV-Projektverzeichnis.
  2. Führen Sie den Befehl aus:
ddev xdebug on

Um zu überprüfen, ob Xdebug aktiviert ist:

ddev describe

Suchen Sie nach dem Xdebug-Abschnitt; dort sollte angegeben sein, dass Xdebug aktiviert ist.

3. VSCode konfigurieren:

  1. Klicken Sie in VSCode in der oberen Symbolleiste auf „Ausführen“.
  2. Klicken Sie auf „Konfiguration öffnen“ (oder eine ähnliche Formulierung, je nach Ihrer VSCode-Version).
  3. Fügen Sie die folgende Konfiguration hinzu:
{
    "name": "Listen for Xdebug",
    "type": "php",
    "request": "launch",
    "hostname": "0.0.0.0",
    "port": 9003,
    "pathMappings": {
        "/var/www/html": "${workspaceFolder}"
    }
}

Stellen Sie sicher, dass diese Konfiguration in der Datei launch.json im Ordner .vscode Ihres Projekts gespeichert ist.

xdebug configuration in vscode
Konfiguration vscode

4. Mit dem Debugging beginnen:

  1. Setzen Sie Breakpoints in Ihrem PHP-Code.
  2. Klicken Sie in VSCode in der oberen Symbolleiste auf „Ausführen“ und dann auf „Debugging starten“.
  3. Initiieren Sie die Aktion in Ihrer Webanwendung, die den Breakpoint auslöst.
Start debugging vscode and xdebug

VSCode sollte nun den Breakpoint erfassen und es Ihnen ermöglichen, Variablen zu inspizieren, durch den Code zu steppen usw.

Debugging with vs code and xdebug
Quelle: https://marketplace.visualstudio.com/items?itemName=xdebug.php-debug

5. Xdebug in DDEV deaktivieren (Optional):

Wenn Sie mit dem Debugging fertig sind, möchten Sie Xdebug möglicherweise in DDEV deaktivieren, um die Leistung zu verbessern:

ddev xdebug off

Viel Spaß beim Debuggen!

Kategorien: