Cryo Sandbox

Du code PHP isolé, exécuté dans le navigateur à côté du jeu : chaque sandbox est un Web Worker avec sa propre instance de PHP. Les appels sont asynchrones, l'image suivante n'attend jamais.

▶ Lancer la démo
La démo après 8 secondes : appels réussis en vert, exception, dépassement mémoire et boucle infinie en rouge, instances relancées
Après 8 s : 6 appels réussis, 3 échecs isolés (exception, mémoire, boucle infinie), deux instances relancées ; le jeu tourne toujours à 60 images/s.

Ce que montre la démo

Touche Espace (ou toucher l'écran) : relancer la série.

Le code

use Cryo\Sandbox\Sandbox;
use JumPHP\Cryo\SandboxLoop;

$sb = SandboxLoop::spawn(['memory_limit' => '32M', 'timeout' => 1]);

$f = $sb->callAsync('str_repeat', ['ab', 3]);
// à chaque image : $f->status() vaut 'pending', puis 'ready' (ou 'failed')
$f->then(fn ($v) => $this->result = $v,             // 'ababab'
         fn ($e) => $this->error = $e->getMessage());

SandboxLoop::wait([$f, $sb->evalAsync('return 21 * 2;')], 5.0)
    ->then(fn ($values) => ...);                      // une Task JumPHP, jamais un sleep

Dans le navigateur, les appels synchrones (call(), eval(), await()) lèvent une exception claire : PHP y tourne image par image et ne peut pas attendre. Sur un serveur ou en CLI, les deux formes existent.

Pendant l'exécution

La démo à 1 seconde : la boucle infinie est encore en attente pendant que l'animation continue
À 1 s : la boucle infinie est encore « pending », l'animation continue.

Questions fréquentes

Est-ce un vrai isolement ? Oui : chaque sandbox a sa propre mémoire WebAssembly dans un Worker. Un plantage (trap), une erreur fatale ou un dépassement mémoire n'y touchent que la sandbox.

Pourquoi pas de synchrone ? Dans une page, PHP s'exécute entre deux images : attendre bloquerait l'affichage. L'API asynchrone (status(), then(), SandboxLoop::wait()) couvre les mêmes besoins.

Où est la documentation ? Sur jumphp.net/docs/cryo, avec des exemples courts ; le détail du fonctionnement est dans docs/cryo.fr.md de JumPHP, et le guide complet de l'extension dans php-cryo.

▶ Lancer la démo