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

74 lines
1.4 KiB
Markdown

# 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.