Cryo Studio
Trouvez la ligne PHP qui fuit, à partir de snapshots mémoire .cryo.
SqlLogger::$log.Ce que fait Cryo Studio
Un processus PHP qui tourne longtemps (worker, démon, serveur applicatif) grossit lot après lot ? L'extension
ext-cryo écrit des snapshots du graphe d'objets avec cryo_snapshot(), et retient pour
chaque objet la ligne qui l'a créé. Cryo Studio compare ces snapshots et classe les sites d'allocation :
combien d'objets chacun crée par intervalle, combien survivent jusqu'au dernier snapshot, et lesquels ne libèrent
jamais rien — ceux-là sont marqués [LEAK].
- Fuites : par site d'allocation, par classe ou par pile d'appels ; nouveaux objets par intervalle, survivants, taux de survie et la colonne accroché par (la ligne qui a stocké les objets). Le détail montre le code de la ligne de création et de la ligne d'écriture, et le chemin type qui garde les survivants.
- Vue d'ensemble : les alertes des heuristiques (croissance, cache statique, orphelins, log en mémoire, listeners) avec leur chemin, les classes, les sites et les racines du snapshot.
- Classes : triées par taille retenue ; un clic liste les instances, un autre ouvre l'inspecteur.
- Inspecteur de nœud : type, classe, taille, taille retenue, site de création, d'écriture, pile, références sortantes et entrantes cliquables, et le chemin vers une racine.
- Dominateurs, orphelins (cycles non collectés, par classe), doublons (chaînes et tableaux copiés).
- Requête :
class=Query and retained>1K,class=App\* or type=string and size>=10K… - Série : la courbe mémoire d'un fichier
.cryomet ses repères. - Pile : un fichier de freeze
.cryfécrit parcryo_freeze(): les frames du script gelé, leurs variables et la ligne où chacune attendait, sans exécuter une ligne du fichier. - Live : branché sur un script qui tourne (
cryo_metrics_serve()), la courbe mémoire en direct, les compteurs (objets vivants, GC, objets par classe) et un bouton Snapshot : le script écrit uncryo_snapshot()à son prochain point sûr, Cryo Studio le reçoit et l'ajoute aux snapshots ; deux snapshots Live successifs donnent un delta.
Essayer en 3 étapes
- 1. Ouvrir
Cliquez sur Ouvrir Cryo Studio : la démo (un worker de commandes) est chargée. - 2. Lire les fuites
La première ligne est la fuite : son code de création, la ligne qui l'accroche, le chemin qui la garde. Puis passez d'un écran à l'autre avec les boutons du haut. - 3. Vos fichiers
« Ouvrir .cryo » ouvre vos propres snapshots (plusieurs à la fois) et vos séries.cryom; ils restent dans votre navigateur.
Produire des snapshots
php -d extension=cryo -d cryo.track_alloc=stack worker.php
// dans worker.php :
cryo_metrics_sample(50, __DIR__ . "/worker.cryom"); // la mémoire toutes les 50 ms
// ... après chaque lot :
cryo_snapshot(__DIR__ . "/snap-$batch.cryo");
cryo_metrics_mark("lot $batch");
Puis ouvrez les fichiers snap-*.cryo et worker.cryom dans Cryo Studio, ou en ligne de commande :
cryo-inspect delta snap-*.cryo. cryo.track_alloc=site suffit pour les sites de création et
d'écriture ; stack ajoute la pile d'appels.
Mode Live : un script qui tourne
php -d extension=cryo -d cryo.track_alloc=site -d cryo.metrics=1 worker.php
// au début de worker.php :
cryo_metrics_serve(9600, "127.0.0.1", [
"cors" => "*", // ou "https://jumphp.net" : la page peut l'interroger
"token" => getenv("CRYO_TOKEN"), // optionnel : ?token= ou Authorization: Bearer
]);
Dans Cryo Studio, écran Live : l'adresse http://127.0.0.1:9600, le jeton, « Connecter ».
L'exportateur est un petit processus fils : le script n'attend jamais la page. Il sert aussi /metrics
(Prometheus), /metrics.json, /series.json et POST /snapshot.

Captures










.cryom et ses repères.Questions fréquentes
Qu'est-ce qu'un fichier .cryo ? Un snapshot du graphe d'objets d'un processus PHP écrit par ext-cryo :
objets, tableaux, chaînes, références, racines et, avec cryo.track_alloc=site ou stack, la ligne qui a
créé chaque objet, celle qui l'a stocké et la pile d'appels.
Et un fichier .cryom ? Une série de mesures de la mémoire écrite par cryo_metrics_sample(),
avec les repères de cryo_metrics_mark() : l'écran Série la dessine.
Faut-il ext-cryo pour lire ? Non : dans le navigateur, Cryo Studio lit les fichiers avec son lecteur écrit en PHP, qui donne les mêmes résultats que l'extension. ext-cryo sert à produire les snapshots.
Mes fichiers sont-ils envoyés ? Non, ils sont lus par le PHP qui tourne dans votre navigateur.
Le mode Live marche-t-il depuis le navigateur ? Oui : la page interroge directement le script, grâce aux
en-têtes CORS de cryo_metrics_serve() (option cors ; le préflight et l'accès d'une page publique à
127.0.0.1 sont gérés). Votre navigateur peut demander l'autorisation d'accéder au réseau local : acceptez-la.
Les données vont du script à votre navigateur, sans serveur entre les deux. Avec token, seul celui qui connaît
le jeton lit les mesures et prend des snapshots.
Et si le script dort ? Le snapshot est pris au prochain point sûr de la machine virtuelle PHP ; un script
bloqué plus de 10 secondes dans un sleep() ou une entrée-sortie renvoie une erreur 504, la courbe continue.