Co-Authored-By: Claude Sonnet 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_018nX3d1jqkxbS2Bhas8tTzM
3.5 KiB
Le profileur de l'IDE
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 ; unrunavec 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
- 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).
- 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é.
- 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.
- 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).
- 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
updateetrender. - 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.
- 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). - Exporter : Export for speedscope écrit
var/profiles/<id>/profile.speedscope.json; Copy a summary for an AI copie un Markdown compact des points chauds (avecfichier: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.