winzik/docs/ide/fr/debugger.md
2026-11-16 08:53:45 +01:00

40 lines
2.1 KiB
Markdown

# Débogueur
Débogage pas à pas de PHP avec **Xdebug** ou **PHP Debugger** (bureau).
## Points d'arrêt
Cliquez dans la gouttière à gauche d'une ligne (clic droit : une condition ; `Ctrl+F8` au curseur). Ils sont gardés par projet et suivent
leurs lignes quand vous éditez. **Stop at Exceptions…** (le ⚠ de la fenêtre Debug) : `*` ou des noms de classes, il s'arrête là où
l'une est levée.
## Debug
**Debug** (`Shift+F9`, l'insecte à côté de Run) lance la configuration sélectionnée sous le débogueur. Là où il s'arrête : la ligne
est marquée et la fenêtre **Debug** montre la pile (cliquez sur un cadre), les variables en arbre, les surveillances, une expression
évaluée à cet endroit, et une variable peut recevoir une nouvelle valeur (double clic ou `F2`).
| Action | Raccourci |
|---|---|
| Resume | `F9` |
| Step Over / Into / Out | `F8` / `F7` / `Shift+F8` |
| Run to Cursor | `Alt+F9` |
| Stop | `Ctrl+F2` |
Survoler une variable dans l'éditeur à l'arrêt montre sa valeur.
## Moteurs
Xdebug par défaut ; [PHP Debugger](https://php-debugger.dev) est bien plus rapide : **Debug with…** (clic droit sur le bouton Debug)
en choisit un pour une exécution et peut en faire le moteur par défaut.
## Sites web
Debug sur **Serve the site** active Xdebug dans le conteneur du site : les points d'arrêt arrêtent les requêtes.
## Conseils
Les exécutions sans fenêtre (`shot`, `test`) sont les meilleures : un jeu arrêté dans une fenêtre reste figé jusqu'à la reprise. Claude
peut piloter le même débogueur ([Claude](claude.md)). Plus de détails : [docs/ide-debugger.md](../../ide-debugger.md).
Les arbres (Variables, Watches, carte au survol) ne lisent que les enfants de la ligne ouverte et gardent toutes les autres lignes, le défilement et ce que vous avez ouvert. Une valeur illisible affiche `error: ...` dans sa propre ligne. La carte reste ouverte tant que le pointeur est dessus ou qu'une lecture est en cours, grandit jusqu'à une hauteur maximale puis défile, et se ferme avec Échap, un clic à côté, ou quand le pointeur l'a quittée depuis plus de 300 ms.