Co-Authored-By: Claude Sonnet 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_018nX3d1jqkxbS2Bhas8tTzM
45 lines
3.5 KiB
Markdown
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.
|