ext-cryo : snapshot et analyse de fuites mémoire, congélation/reprise de scripts, fork, sandboxes (CLI et navigateur), Cryo\Engine, métriques — et Cryo Studio. Guide : docs/guide, exemples : examples/
  • C 58.7%
  • PHP 40.4%
  • JavaScript 0.6%
  • M4 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-15 11:16:30 +01:00
.forgejo/workflows CI : checkout par git (actions/checkout demande Node, absent des images php) 2026-11-14 19:46:39 +01:00
bridge cryo/bridge : warm boot clé en main, ressources, contexte, adaptateurs Laravel / Symfony / JumPHP 2026-11-14 17:48:37 +01:00
cryo-studio Guide en français (docs/guide, 11 chapitres) et 13 exemples simples vérifiés par examples/run.sh (CI) 2026-11-14 19:15:16 +01:00
docs Dépôt déplacé dans l'organisation jumphp : git.jumphp.net/jumphp/php-cryo 2026-11-14 19:44:01 +01:00
examples cryo_memory_watch() congelée avec le script : après cryo_restart(), le nouveau processus surveille encore (réarmée sous 90 %) ; test 029, exemple 05 2026-11-14 19:29:25 +01:00
ext-cryo Typed properties holding a frozen value (a closure, a resource, a raw object with __wakeup, an excluded object) come back: unserialize() refused the Cryo\Frozen marker in them ("Cannot assign Cryo\Frozen to property X of type Y"); the markers are kept aside with their object, the properties left uninitialized while serialized, and put back once thawed (test 324) 2026-11-15 11:16:30 +01:00
tools Dépôt déplacé dans l'organisation jumphp : git.jumphp.net/jumphp/php-cryo 2026-11-14 19:44:01 +01:00
wasm-host Doc et hôte JS de référence : sandbox asynchrone dans le navigateur (recv non bloquant, arm, status/error) 2026-11-14 18:50:47 +01:00
.gitignore Fuzzing des lecteurs de fichiers (tools/fuzz-readers.php) et corrections 2026-11-14 18:01:20 +01:00
README.md Guide en français (docs/guide, 11 chapitres) et 13 exemples simples vérifiés par examples/run.sh (CI) 2026-11-14 19:15:16 +01:00

PhpCryo — ext-cryo + Cryo Studio

Cryo congèle un script PHP en cours dans un fichier, le reprend dans un processus neuf, montre quelle ligne de code fait fuir la mémoire, et pilote des moteurs PHP isolés. CLI Linux et PHP compilé en WebAssembly (moteur JumPHP).

Dossier Rôle
ext-cryo/ l'extension C (toutes les fonctions : voir ext-cryo/README.md et ext-cryo/cryo.stub.php)
cryo-studio/ bibliothèque PHP de Cryo Studio : lecteurs .cryo / .cryom en pur PHP (PhpCryoReader, PhpCryoDelta, MetricSeries), mêmes résultats que l'extension
bridge/ cryo/bridge : warm boot clé en main (WarmBoot::run()), handlers de ressources (CryoPdo, CryoCurl, Reconnectable), Context par exécution, adaptateurs Laravel, Symfony et JumPHP (CLI) — voir bridge/README.md
wasm-host/ @cryo/wasm-host : attachCryoHost(php, opts), l'hôte JS (restart, clone, sandboxes, canal, métriques)
docs/guide/ le guide (français) : analyse mémoire, congélation, fork, sandbox, Engine, métriques, sécurité, outils, navigateur, référence
examples/ 13 exemples courts et commentés, vérifiés par examples/run.sh
docs/SPEC.md la spécification (plan, RFC, documentation)
tools/sync-jumphp.sh copie ext-cryo dans JumPHP (docker/ext/cryo), où le moteur WASM et l'image desktop la compilent

L'application Cryo Studio (JumPHP) : https://jumphp.net/cryo-studio — dépôt git.jumphp.net/duchnoun/cryo-studio.

Démarrage rapide

Commencez par le guide et les exemples.

cd ext-cryo
phpize && ./configure --enable-cryo && make && NO_INTERACTION=1 make test          # 68 tests
php -d extension=$PWD/modules/cryo.so -d cryo.track_alloc=site examples/demo_leak.php
php -d extension=$PWD/modules/cryo.so -d cryo.track_alloc=site ../cryo-studio/tests/compare_readers.php

Testé : PHP 8.4.27 et 8.5.12 NTS, Linux x86_64 ; le moteur WebAssembly de JumPHP se construit avec ext-cryo.

Feuille de route

Jalon Contenu État
1 snapshot, sites d'allocation, CryoReader, delta, cryo-inspect fait
2 analyse complète (chemins, dominateurs, orphelins, doublons, requêtes, sites d'écriture, piles, heuristiques) + métriques (.cryom, Prometheus, StatsD, OTLP) fait
3 Cryo Studio (application JumPHP) fait
4 restart, memory watch, fork pool, modes fork, hooks, ressources fait
5 freeze / thaw de la pile complète fait
6 Cryo\Sandbox, Cryo\Engine fait
7 warm boot, signature obligatoire, compression, chiffrement fait