Xdebug in WordPress Studio

Questo testo è stato tradotto utilizzando l’IA. Se desideri visualizzare il testo originale in inglese, fai clic qui.

Xdebug è un’estensione di debug per PHP che consente di impostare breakpoint, ispezionare variabili e analizzare il codice passo dopo passo. WordPress Studio include il supporto per Xdebug, basato sulla versione WebAssembly di PHP di WordPress Playground.

Abilitare Xdebug

1. Seleziona il sito di cui desideri eseguire il debug.
2. Vai alla scheda Impostazioni.
3. Fai clic su «Modifica sito».
4. Seleziona la casella «Abilita Xdebug».
5. Fai clic su Salva.

Il sito si riavvierà automaticamente con Xdebug abilitato.

Limitazioni importanti

• Un solo sito alla volta: Xdebug può essere abilitato solo per un singolo sito alla volta. Per abilitarlo su un sito diverso, è necessario prima disabilitarlo sul sito corrente.
• Impatto sulle prestazioni: Xdebug può rallentare le prestazioni del sito. Disabilitalo quando non stai eseguendo attivamente il debug.

Utilizzare Xdebug con il tuo IDE

Una volta abilitato Xdebug per un sito, puoi collegare il tuo IDE (editor di codice) per eseguire il debug di plugin, temi e codice core di WordPress.

Configurazione di Visual Studio Code

1. Installa l’estensione PHP Debug.
2. Crea un file .vscode/launch.json nel tuo progetto con la seguente configurazione:

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

3. Imposta i breakpoint nel tuo codice.
4. Avvia la sessione di debug in Visual Studio Code (Esegui → Avvia debug).
5. Naviga sul tuo sito nel browser per attivare i breakpoint.

Configurazione di PhpStorm

1. Vai su Settings (Impostazioni) → PHP → Debug.
2. Verifica che la porta di Xdebug sia impostata su 9003.
3. Per evitare l’interruzione alla prima riga:
   • Disabilita “Force break at first line when no path mapping specified” (Forza interruzione alla prima riga quando non è specificata alcuna mappatura dei percorsi)
   • Disabilita “Force break at first line when a script is outside the project” (Forza interruzione alla prima riga quando uno script è fuori dal progetto)
4. Vai su Settings (Impostazioni) -> PHP → Servers e configura la mappatura per il server del tuo sito:
   • Host: localhost:8884
   • Port: 80
   • File directory: /Users/USERNAME/Studio/SITEDIR
   • Absolute path on the server: /wordpress
5. Abilita «Start listening for PHP Debug Connections» (Inizia ad ascoltare le connessioni di debug PHP) dalla barra degli strumenti.
6. Imposta i breakpoint nel tuo codice.
7. Naviga sul tuo sito nel browser per attivare i breakpoint.

Per saperne di più

Per ulteriori informazioni sull’integrazione di Xdebug, consulta la documentazione Xdebug di WordPress Playground.