Files
elixforms-web-services/docs/debug-api-vscode-docker.md
T
2026-07-16 12:18:53 +02:00

1.4 KiB

Debug delle API PHP in VS Code con Docker

Queste istruzioni permettono di fare debug delle API PHP servite con Docker direttamente da Visual Studio Code.

Prerequisiti

  • Docker Desktop installato e in esecuzione
  • Visual Studio Code
  • Estensione PHP per VS Code

1. Avvia il container

Dalla root del progetto esegui:

docker compose up --build

Il server PHP sarà disponibile su:

http://localhost:8000

2. Avvia il debug in VS Code

Apri la sezione Run and Debug e seleziona la configurazione:

Debug PHP in Docker

Poi premi F5.

3. Imposta un breakpoint

Aggiungi un breakpoint in un controller, ad esempio in:

src/Api/Controllers/V1/UsersController.php

Quindi richiama un endpoint come:

http://localhost:8000/api/users

4. Se il debugger non parte

Prova a inviare la richiesta con il trigger Xdebug:

curl -H "XDEBUG_TRIGGER: 1" http://localhost:8000/api/users

5. Configurazione attesa

Il progetto contiene già:

  • un Dockerfile PHP con Xdebug
  • un file docker-compose.yml
  • una configurazione di avvio VS Code in .vscode/launch.json

6. Nota importante

Il server PHP viene eseguito con:

php -S 0.0.0.0:8000 -t public public/index.php

Questa modalità è adatta per il debug delle API HTTP del progetto.