RU
apps/cryo-studio / site / index.html · commit 76aa68d
<!doctype html><html lang="fr"><head>  <meta charset="utf-8">  <meta name="viewport" content="width=device-width, initial-scale=1">  <title>Cryo Studio – trouver les fuites mémoire PHP en ligne, gratuit</title>  <meta name="description" content="Cryo Studio analyse les snapshots mémoire .cryo d'un processus PHP : la ligne qui fuit et celle qui garde ses objets, alertes, classes, inspecteur de nœud, dominateurs, orphelins, doublons, requêtes, courbe mémoire et mode Live (un script qui tourne). Gratuit, dans le navigateur.">  <link rel="canonical" href="https://{{DOMAIN}}/">  <link rel="icon" href="images/favicon.png">  <meta property="og:type" content="website">  <meta property="og:url" content="https://{{DOMAIN}}/">  <meta property="og:locale" content="fr_FR">  <meta property="og:title" content="Cryo Studio – trouver les fuites mémoire PHP">  <meta property="og:description" content="Comparez des snapshots .cryo et trouvez la ligne PHP qui garde tous ses objets en mémoire.">  <meta property="og:image" content="https://{{DOMAIN}}/images/og.png">  <meta name="twitter:card" content="summary_large_image">  <meta name="twitter:title" content="Cryo Studio – trouver les fuites mémoire PHP">  <meta name="twitter:description" content="Comparez des snapshots .cryo et trouvez la ligne PHP qui garde tous ses objets en mémoire.">  <meta name="twitter:image" content="https://{{DOMAIN}}/images/og.png">  <script type="application/ld+json">{  "@context": "https://schema.org",  "@type": "SoftwareApplication",  "name": "Cryo Studio",  "description": "Analyseur de snapshots mémoire .cryo produits par l'extension PHP ext-cryo : delta par site, classe ou pile avec la ligne d'écriture qui garde les objets, alertes des heuristiques, classes, inspecteur de nœud et chemin vers une racine, dominateurs, orphelins, doublons, langage de requête, courbe mémoire .cryom, mode Live : mémoire d'un script en cours et snapshots à distance via cryo_metrics_serve().",  "url": "https://{{DOMAIN}}/",  "applicationCategory": "DeveloperApplication",  "operatingSystem": "Web browser, Linux, Windows, macOS",  "image": "https://{{DOMAIN}}/images/og.png",  "screenshot": [    "https://{{DOMAIN}}/images/leaks.jpg",    "https://{{DOMAIN}}/images/overview.jpg",    "https://{{DOMAIN}}/images/inspector.jpg",    "https://{{DOMAIN}}/images/series.jpg",    "https://{{DOMAIN}}/images/live.jpg",    "https://{{DOMAIN}}/images/stack.jpg",    "https://{{DOMAIN}}/images/classes.jpg",    "https://{{DOMAIN}}/images/dominators.jpg"  ],  "isAccessibleForFree": true,  "offers": { "@type": "Offer", "price": "0", "priceCurrency": "EUR" },  "inLanguage": "fr",  "potentialAction": { "@type": "UseAction", "target": "https://{{DOMAIN}}/play/" }}  </script>  <script type="application/ld+json">{  "@context": "https://schema.org",  "@type": "FAQPage",  "mainEntity": [    { "@type": "Question", "name": "Qu'est-ce qu'un fichier .cryo ?",      "acceptedAnswer": { "@type": "Answer", "text": "Un snapshot du graphe d'objets d'un processus PHP, écrit par cryo_snapshot() de l'extension ext-cryo : objets, tableaux, chaînes, références, racines (globales, propriétés statiques, variables de frame, orphelins) et, avec cryo.track_alloc=site ou stack, la ligne qui a créé chaque objet, la dernière ligne qui l'a stocké et la pile d'appels." } },    { "@type": "Question", "name": "Faut-il installer ext-cryo pour utiliser Cryo Studio ?",      "acceptedAnswer": { "@type": "Answer", "text": "Non pour lire : dans le navigateur, Cryo Studio lit les fichiers .cryo avec son propre lecteur écrit en PHP, qui donne les mêmes résultats que l'extension. Oui pour produire les snapshots, dans votre application." } },    { "@type": "Question", "name": "Qu'est-ce qu'un fichier .cryom ?",      "acceptedAnswer": { "@type": "Answer", "text": "Une série de mesures de la mémoire écrite en tâche de fond par cryo_metrics_sample(), avec des repères posés par cryo_metrics_mark(). Cryo Studio la dessine en courbe." } },    { "@type": "Question", "name": "Mes fichiers sont-ils envoyés quelque part ?",      "acceptedAnswer": { "@type": "Answer", "text": "Non. Les fichiers que vous ouvrez sont lus par le PHP qui tourne dans votre navigateur (WebAssembly) ; rien n'est envoyé à un serveur." } },    { "@type": "Question", "name": "Le mode Live marche-t-il depuis le navigateur ?",      "acceptedAnswer": { "@type": "Answer", "text": "Oui. Le script lance cryo_metrics_serve(9600, '127.0.0.1', ['cors' => '*', 'token' => '...']) : l'exportateur d'ext-cryo répond aux requêtes de la page grâce à ses en-têtes CORS (préflight et accès au réseau local compris). L'écran Live interroge /metrics.json toutes les 2 secondes et le bouton Snapshot demande au script un cryo_snapshot() à distance, qui rejoint les snapshots analysés. Les données vont directement de votre navigateur au script, sans passer par un serveur." } }  ]}  </script>  <style>    :root { --bg: #f3f4f7; --panel: #ffffff; --text: #1d2433; --muted: #5b6478; --accent: #2f7fd8; --deep: #1a4a8c; --line: #dfe3ea; }    * { box-sizing: border-box; }    body { margin: 0; background: var(--bg); color: var(--text); font: 17px/1.6 system-ui, -apple-system, "Segoe UI", sans-serif; }    main { max-width: 1040px; margin: 0 auto; padding: 24px 16px 64px; }    header { display: flex; gap: 20px; align-items: center; flex-wrap: wrap; padding: 24px 0 8px; }    header img { width: 72px; height: 72px; }    header div { flex: 1; min-width: 240px; }    h1 { font-size: clamp(32px, 6vw, 48px); margin: 0; line-height: 1.1; }    .tag { margin: 6px 0 0; color: var(--muted); font-size: 19px; }    h2 { margin: 48px 0 12px; font-size: 26px; }    p, li { color: var(--muted); }    strong { color: var(--text); }    code { background: #e7ebf2; padding: 1px 6px; border-radius: 4px; font-size: 15px; word-break: break-word; }    pre { background: #1d2433; color: #e8f6ff; padding: 16px; border-radius: 10px; overflow-x: auto; font-size: 14px; line-height: 1.5; }    .play { display: inline-block; margin: 16px 0; padding: 14px 34px; border-radius: 10px; background: var(--accent); color: #fff;      font-weight: 700; font-size: 20px; text-decoration: none; box-shadow: 0 4px 0 var(--deep); }    .play:active { transform: translateY(3px); box-shadow: 0 1px 0 var(--deep); }    figure { margin: 0; }    figure img { width: 100%; height: auto; border-radius: 10px; border: 1px solid var(--line); display: block; background: #fff; }    figcaption { color: var(--muted); font-size: 15px; margin-top: 6px; }    .hero { margin-top: 16px; }    .gallery { display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 20px; }    .steps { display: grid; grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); gap: 16px; padding: 0; list-style: none; }    .steps li { background: var(--panel); border: 1px solid var(--line); border-radius: 10px; padding: 16px; }    footer { text-align: center; color: var(--muted); font-size: 14px; margin-top: 56px; }    a { color: var(--accent); }  </style></head><body>  <main>    <header>      <img src="images/logo.png" alt="Logo de Cryo Studio : un cristal de glace" width="72" height="72">      <div>        <h1>Cryo Studio</h1>        <p class="tag">Trouvez la ligne PHP qui fuit, à partir de snapshots mémoire <code>.cryo</code>.</p>      </div>      <a class="play" href="play/">▶ Ouvrir Cryo Studio</a>    </header>    <figure class="hero">      <img src="images/leaks.jpg" alt="Cryo Studio : le delta de 5 snapshots désigne SqlLogger::log comme fuite, avec le code de la ligne 17 qui crée les objets et de la ligne 18 qui les accroche" width="1024" height="700">      <figcaption>Cinq snapshots d'un worker : <strong>SqlLogger::log</strong> crée 80 objets par lot à la ligne 17 et la ligne 18 les accroche tous dans <code>SqlLogger::$log</code>.</figcaption>    </figure>    <h2>Ce que fait Cryo Studio</h2>    <p>Un processus PHP qui tourne longtemps (worker, démon, serveur applicatif) grossit lot après lot ? L'extension      <strong>ext-cryo</strong> écrit des snapshots du graphe d'objets avec <code>cryo_snapshot()</code>, et retient pour      chaque objet la ligne qui l'a créé. Cryo Studio compare ces snapshots et classe les <strong>sites d'allocation</strong> :      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 <strong>[LEAK]</strong>.</p>    <ul>      <li><strong>Fuites</strong> : par site d'allocation, par classe ou par pile d'appels ; nouveaux objets par intervalle, survivants,        taux de survie et la colonne <strong>accroché par</strong> (la ligne qui a stocké les objets). Le détail montre le code de la        ligne de création <em>et</em> de la ligne d'écriture, et le chemin type qui garde les survivants.</li>      <li><strong>Vue d'ensemble</strong> : 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.</li>      <li><strong>Classes</strong> : triées par taille retenue ; un clic liste les instances, un autre ouvre l'inspecteur.</li>      <li><strong>Inspecteur de nœud</strong> : type, classe, taille, taille retenue, site de création, d'écriture, pile, références        sortantes et entrantes cliquables, et le <strong>chemin vers une racine</strong>.</li>      <li><strong>Dominateurs</strong>, <strong>orphelins</strong> (cycles non collectés, par classe), <strong>doublons</strong>        (chaînes et tableaux copiés).</li>      <li><strong>Requête</strong> : <code>class=Query and retained&gt;1K</code>, <code>class=App\* or type=string and size&gt;=10K</code>…</li>      <li><strong>Série</strong> : la courbe mémoire d'un fichier <code>.cryom</code> et ses repères.</li>      <li><strong>Pile</strong> : un fichier de freeze <code>.cryf</code> écrit par <code>cryo_freeze()</code> : les frames du        script gelé, leurs variables et la ligne où chacune attendait, sans exécuter une ligne du fichier.</li>      <li><strong>Live</strong> : branché sur un script qui tourne (<code>cryo_metrics_serve()</code>), la courbe mémoire en direct,        les compteurs (objets vivants, GC, objets par classe) et un bouton <strong>Snapshot</strong> : le script écrit un        <code>cryo_snapshot()</code> à son prochain point sûr, Cryo Studio le reçoit et l'ajoute aux snapshots ; deux snapshots        Live successifs donnent un delta.</li>    </ul>    <h2>Essayer en 3 étapes</h2>    <ol class="steps">      <li><strong>1. Ouvrir</strong><br>Cliquez sur <a href="play/">Ouvrir Cryo Studio</a> : la démo (un worker de commandes) est chargée.</li>      <li><strong>2. Lire les fuites</strong><br>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.</li>      <li><strong>3. Vos fichiers</strong><br>« Ouvrir .cryo » ouvre vos propres snapshots (plusieurs à la fois) et vos séries <code>.cryom</code> ; ils restent dans votre navigateur.</li>    </ol>    <h2>Produire des snapshots</h2>    <pre>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");</pre>    <p>Puis ouvrez les fichiers <code>snap-*.cryo</code> et <code>worker.cryom</code> dans Cryo Studio, ou en ligne de commande :      <code>cryo-inspect delta snap-*.cryo</code>. <code>cryo.track_alloc=site</code> suffit pour les sites de création et      d'écriture ; <code>stack</code> ajoute la pile d'appels.</p>    <h2>Mode Live : un script qui tourne</h2>    <pre>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]);</pre>    <p>Dans Cryo Studio, écran <strong>Live</strong> : l'adresse <code>http://127.0.0.1:9600</code>, le jeton, « Connecter ».      L'exportateur est un petit processus fils : le script n'attend jamais la page. Il sert aussi <code>/metrics</code>      (Prometheus), <code>/metrics.json</code>, <code>/series.json</code> et <code>POST /snapshot</code>.</p>    <figure><img src="images/live.jpg" alt="Écran Live : courbe mémoire d'un script en cours, deux snapshots pris à distance marqués sur la courbe et ajoutés à la liste des snapshots" width="1024" height="700" loading="lazy"><figcaption>Le mode Live : la mémoire en direct et deux snapshots pris à distance.</figcaption></figure>    <h2>Captures</h2>    <div class="gallery">      <figure><img src="images/overview.jpg" alt="Vue d'ensemble : alertes des heuristiques, dont le log en mémoire $audit de 400 chaînes et son chemin" width="1024" height="700" loading="lazy"><figcaption>Les alertes des heuristiques et leur chemin.</figcaption></figure>      <figure><img src="images/cache.jpg" alt="Le cache borné PriceCache::get garde 25 % de ses objets, accrochés par la ligne 73 de handleBatch" width="1024" height="700" loading="lazy"><figcaption>Un cache borné : 25 % de survie, accroché par une autre ligne.</figcaption></figure>      <figure><img src="images/bystack.jpg" alt="Delta par pile d'appels : SqlLogger::log appelé par handleBatch appelé par main" width="1024" height="700" loading="lazy"><figcaption>Le delta par pile d'appels.</figcaption></figure>      <figure><img src="images/classes.jpg" alt="Classes triées par taille retenue et les 400 instances de Query" width="1024" height="700" loading="lazy"><figcaption>Classes par taille retenue, puis leurs instances.</figcaption></figure>      <figure><img src="images/inspector.jpg" alt="Inspecteur du nœud Query #498 : site de création, d'écriture, pile, références et chemin depuis SqlLogger::$log" width="1024" height="700" loading="lazy"><figcaption>L'inspecteur et le chemin vers une racine.</figcaption></figure>      <figure><img src="images/dominators.jpg" alt="Dominateurs : le tableau SqlLogger::$log retient 53 Ko" width="1024" height="700" loading="lazy"><figcaption>Les nœuds qui retiennent le plus.</figcaption></figure>      <figure><img src="images/orphans.jpg" alt="Orphelins : 10 objets Connection gardés par des cycles non collectés" width="1024" height="700" loading="lazy"><figcaption>Les orphelins, groupés par classe.</figcaption></figure>      <figure><img src="images/query.jpg" alt="Requête class=Price* and epoch>=4 : 60 nœuds" width="1024" height="700" loading="lazy"><figcaption>Le langage de requête.</figcaption></figure>      <figure><img src="images/stack.jpg" alt="Pile d'un fichier de freeze : JobQueue::process ligne 29, ses variables $job et $i, et le code de la ligne" width="1024" height="700" loading="lazy"><figcaption>La pile d'un freeze : frames, variables, code.</figcaption></figure>      <figure><img src="images/series.jpg" alt="Courbe mémoire d'une série .cryom avec les repères des 5 snapshots" width="1024" height="700" loading="lazy"><figcaption>La courbe mémoire d'un <code>.cryom</code> et ses repères.</figcaption></figure>    </div>    <h2>Questions fréquentes</h2>    <p><strong>Qu'est-ce qu'un fichier .cryo ?</strong> Un snapshot du graphe d'objets d'un processus PHP écrit par ext-cryo :      objets, tableaux, chaînes, références, racines et, avec <code>cryo.track_alloc=site</code> ou <code>stack</code>, la ligne qui a      créé chaque objet, celle qui l'a stocké et la pile d'appels.</p>    <p><strong>Et un fichier .cryom ?</strong> Une série de mesures de la mémoire écrite par <code>cryo_metrics_sample()</code>,      avec les repères de <code>cryo_metrics_mark()</code> : l'écran Série la dessine.</p>    <p><strong>Faut-il ext-cryo pour lire ?</strong> 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.</p>    <p><strong>Mes fichiers sont-ils envoyés ?</strong> Non, ils sont lus par le PHP qui tourne dans votre navigateur.</p>    <p><strong>Le mode Live marche-t-il depuis le navigateur ?</strong> Oui : la page interroge directement le script, grâce aux      en-têtes CORS de <code>cryo_metrics_serve()</code> (option <code>cors</code> ; le préflight et l'accès d'une page publique à      <code>127.0.0.1</code> 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 <code>token</code>, seul celui qui connaît      le jeton lit les mesures et prend des snapshots.</p>    <p><strong>Et si le script dort ?</strong> Le snapshot est pris au prochain point sûr de la machine virtuelle PHP ; un script      bloqué plus de 10 secondes dans un <code>sleep()</code> ou une entrée-sortie renvoie une erreur 504, la courbe continue.</p>    <p style="text-align: center"><a class="play" href="play/">▶ Analyser des snapshots</a></p>    <footer>Cryo Studio — application JumPHP écrite en PHP, dessinée sans HTML.</footer>  </main></body></html>