winzik/docs/ide-profiler.fr.md

45 lines
3.5 KiB
Markdown

# Le profileur de l'IDE
[English](ide-profiler.md)
Où un programme passe-t-il son **temps CPU** et sa **mémoire** ? Le Profileur de l'IDE lance une configuration d'exécution (un jeu, une appli
graphique / CLI / bureau, les tests du projet, une capture) sous le profileur de **Xdebug 3** et montre la réponse : d'abord des images,
les chiffres à la demande.
## L'utiliser
- **Run > Profile…** (Alt+Maj+P), la fenêtre **Profiler** (bande de droite, Alt+P), ou **Profile…** en bas de la liste des configurations.
- Choisissez *quoi* (temps CPU, mémoire, ou les deux), *quel programme* (la configuration sélectionnée) et *jusqu'à quand* : la fin du
programme, N secondes, ou N images (jeu : 60 images = 1 seconde ; `JUMPHP_MAX_FRAMES`). Une exécution sans fenêtre (`shot`, `test`) avec N
images est le moyen le plus rapide de profiler un jeu ; un `run` avec fenêtre attend que vous la fermiez.
- Le premier profil construit une seule fois l'image Docker avec Xdebug (environ une minute ; l'IDE le dit). Tout tourne dans Docker
via `bin/jumphp`, comme Debug.
## Ce que vous voyez
1. **Un résumé** : temps CPU, pic de mémoire, mémoire allouée, appels, et où va le temps propre (votre code, le moteur JumPHP, les bibliothèques, PHP).
2. **Un graphe en flammes** : clic sur une case pour zoomer, double-clic pour ouvrir le code, recherche, *Icicle* pour le retourner,
*Size: time / memory*. Les couleurs suivent l'espace de noms. Une exécution CPU seule le dessine d'après le graphe des appels (le profil
Xdebug garde qui appelle qui, pas chaque appel dans l'ordre) ; avec la trace mémoire c'est le vrai arbre des appels fusionné.
3. **La mémoire dans le temps** (trace activée) : faites glisser sur le graphique pour choisir une partie de l'exécution ; les points chauds suivent.
4. **Points chauds** : les 10 fonctions au plus de temps CPU propre, de mémoire allouée, d'appels. Un clic ouvre le code à cette ligne.
Profil chargé, la **gouttière des éditeurs** montre le coût des lignes (une bande rouge discrète ; l'interrupteur est dans la barre d'outils).
5. **Une image du jeu** (jeux JumPHP) : temps par image réparti moteur / mise à jour / rendu, budget de 60 FPS, images par seconde, images les
plus lentes, ce que vos scènes dépensent dans `update` et `render`.
6. **Détails** (barre d'outils) : l'arbre des appels (déplier, trier), appelants et appelés de la fonction choisie, totaux par fichier et par
classe, chiffres bruts.
7. **Comparer** : le menu horloge garde les 20 dernières exécutions de chaque programme (`var/profiles/`) ; choisissez-en deux pour voir ce qui
est plus lent / rapide, plus lourd / léger (vert = mieux, rouge = pire).
8. **Exporter** : *Export for speedscope* écrit `var/profiles/<id>/profile.speedscope.json` ; *Copy a summary for an AI* copie un Markdown
compact des points chauds (avec `fichier:ligne`).
## Pour Claude (outils MCP de l'IDE)
`profile_run`, `profile_summary`, `profile_compare` : une IA profile, lit, optimise, reprofile. Ils passent par le circuit de permissions de l'IDE
comme tout outil qui lance un programme.
## Moteurs
`ProfilerEngine` : un moteur dit ce qu'il sait mesurer et comment `bin/jumphp` lance le programme. **Xdebug** est le seul qui mesure. **PHP Debugger**
est un débogueur pas à pas : son extension ne déclare que la fonction « Step Debugger » (mode `debug` seul, vérifié avec `php --ri php_debugger`,
version 0.4.1) : il ne peut pas profiler et reste listé avec cette raison.