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%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .forgejo/workflows | ||
| bridge | ||
| cryo-studio | ||
| docs | ||
| examples | ||
| ext-cryo | ||
| tools | ||
| wasm-host | ||
| .gitignore | ||
| README.md | ||
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 |