separate skills

2026-07-16 14:42:59 +02:00
parent 17d48fa051
commit 04ed2a7120
2 changed files with 47 additions and 50 deletions
@@ -0,0 +1,46 @@
+# Debug API PHP con VS Code e Docker
+
+Questa sezione descrive la procedura per fare debug delle API PHP servite da Docker in questa repository.
+
+## Passaggi
+
+1. Avvia il container Docker dalla root del progetto:
+   ```bash
+   docker compose up --build
+   ```
+
+2. Apri Visual Studio Code e vai su "Run and Debug".
+
+3. Seleziona la configurazione:
+   ```text
+   Debug PHP in Docker
+   ```
+
+4. Premi F5 per avviare il debugger.
+
+5. Imposta un breakpoint in un controller, ad esempio in:
+   ```text
+   src/Api/Controllers/V1/UsersController.php
+   ```
+
+6. Richiama l’endpoint tramite browser o curl:
+   ```bash
+   curl -H "XDEBUG_TRIGGER: 1" http://localhost:8000/api/users
+   ```
+
+## Nota
+
+Il container deve esporre:
+- porta `8000` per HTTP
+- porta `9003` per Xdebug
+
+Il progetto contiene già i file necessari per il debug:
+- `.docker/php/Dockerfile`
+- `docker-compose.yml`
+- `.vscode/launch.json`
+- `.vscode/settings.json`
+
+## Problemi comuni
+
+- Se VS Code non si ferma sul breakpoint, verifica che Xdebug sia abilitato nel container e che la configurazione `client_host` punti a `host.docker.internal`.
+- Se il container non si avvia, controlla che Docker Desktop sia in esecuzione.