Torna al blog

Come configurare Xdebug con DDEV in VSCode in 4 passaggi

2023-08-142 min di lettura

Come configurare Xdebug con DDEV in VSCode: In soli quattro semplici passaggi, migliora la tua esperienza di codifica e debug in questo editor popolare, come dettagliato in questo post.

Xdebug è uno strumento di debug e profiling per PHP. Offre stack trace, ispezione delle variabili e breakpoint, oltre a code coverage e profiling delle prestazioni per ottimizzare le applicazioni PHP.

Il debug è il processo di identificazione, diagnosi e correzione di errori o bug nel software. Questi errori possono essere sotto forma di codice errato, errori logici o comportamenti indesiderati che impediscono al software di funzionare come previsto.

1. Installa i prerequisiti:

Assicurati di avere installati i seguenti strumenti:

2. Configura DDEV per Xdebug:

DDEV viene fornito con Xdebug preconfigurato fin da subito. Devi solo abilitarlo:

  1. Naviga nella directory del tuo progetto DDEV.
  2. Esegui il comando:
ddev xdebug on

Per verificare che Xdebug sia abilitato:

ddev describe

Cerca la sezione Xdebug; dovrebbe indicare che Xdebug è abilitato.

3. Configura VSCode:

  1. In VSCode, fai clic su “Esegui” nella barra degli strumenti in alto.
  2. Fai clic su “Apri configurazione” (o una dicitura simile, a seconda della tua versione di VSCode).
  3. Aggiungi la seguente configurazione:
{
    "name": "Listen for Xdebug",
    "type": "php",
    "request": "launch",
    "hostname": "0.0.0.0",
    "port": 9003,
    "pathMappings": {
        "/var/www/html": "${workspaceFolder}"
    }
}

Assicurati che questa configurazione sia salvata nel file launch.json all'interno della cartella .vscode del tuo progetto.

configurazione xdebug in vscode
Configurazione vscode

4. Avvia il debug:

  1. Imposta i breakpoint nel tuo codice PHP.
  2. In VSCode, fai clic su “Esegui” nella barra degli strumenti in alto e poi fai clic su Avvia Debug.
  3. Avvia l'azione nella tua applicazione web che attiva il breakpoint.
Avvia debug vscode e xdebug

VSCode dovrebbe ora catturare il breakpoint, permettendoti di ispezionare le variabili, eseguire il codice passo dopo passo, ecc.

Debug con vs code e xdebug
Fonte: https://marketplace.visualstudio.com/items?itemName=xdebug.php-debug

5. Disabilita Xdebug in DDEV (Opzionale):

Quando hai finito di fare il debug, potresti voler disabilitare Xdebug in DDEV per migliorare le prestazioni:

ddev xdebug off

Buon Debug!