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
Ce que montre la démo
callAsync('str_repeat', ['ab', 3])et un calcul de 4 millions de tours renvoient leur résultat sans geler l'animation.then()enchaîne un appel sur le résultat d'un autre.- Une exception levée dans la sandbox revient comme
RemoteException. - Une chaîne de 100 Mo avec
memory_limit = 32MdonneSandboxMemoryException; une boucle infinie avec untimeoutde 1 s donneSandboxTimeoutException: le Worker est arrêté, une nouvelle instance prend la suite. SandboxLoop::wait()attend plusieurs résultats par la boucle ReactPHP de JumPHP, sans jamais dormir.
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
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.