add php debugging

docs/debug-api-vscode-docker.md

@@ -0,0 +1,73 @@
+# 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:
+
+```bash
+docker compose up --build
+```
+
+Il server PHP sarà disponibile su:
+
+```text
+http://localhost:8000
+```
+
+## 2. Avvia il debug in VS Code
+
+Apri la sezione Run and Debug e seleziona la configurazione:
+
+```text
+Debug PHP in Docker
+```
+
+Poi premi F5.
+
+## 3. Imposta un breakpoint
+
+Aggiungi un breakpoint in un controller, ad esempio in:
+
+```text
+src/Api/Controllers/V1/UsersController.php
+```
+
+Quindi richiama un endpoint come:
+
+```text
+http://localhost:8000/api/users
+```
+
+## 4. Se il debugger non parte
+
+Prova a inviare la richiesta con il trigger Xdebug:
+
+```bash
+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:
+
+```bash
+php -S 0.0.0.0:8000 -t public public/index.php
+```
+
+Questa modalità è adatta per il debug delle API HTTP del progetto.