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