winzik/docs/ide-profiler.fr.md

3.5 KiB

Le profileur de l'IDE

English

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.