Les pièges du navigateur (WebAssembly)
Le même PHP tourne dans le navigateur, avec ces différences :
| Sujet | Dans le navigateur | À faire |
|---|---|---|
| Entiers | 32 bits (PHP_INT_SIZE = 4, max 2 147 483 647) |
temps en float (Time::now(), $engine->time()), couleurs en tableaux / chaînes, pack() sans q J P |
| Boucle | une frame par requestAnimationFrame, rien ne doit bloquer |
jamais sleep, usleep, while(true), fgets(STDIN) ; compter $dt ou GameLoop::addTimer |
| Réseau | pas de sockets, pas de curl | JumPHP\Net (multijoueur), JumPHP\Http (requêtes web, CORS) |
| Fichiers | /game = le jeu (lecture), /game/var = IndexedDB (sauvegardé toutes les 2 s), /tmp = mémoire |
Storage / Options pour écrire |
| Extensions | SDL, SDL_image (png, jpg, bmp), SDL_mixer (wav, ogg, mp3), SDL_ttf, GD (png), mbstring, bcmath, ctype, zlib, json, pcre, tokenizer | pas d'intl, pdo, curl, sockets (TCP : $engine->tcp() par le pont TCP, SSH : $engine->ssh(), voir docs/tcp.md et docs/ssh-wasm.md), pcntl... composer : paquets en PHP pur |
| Textures | largeur ≤ 4064 px (WebGL) | Sdl::loadTexture découpe seul ; getTextures() rend les tranches |
| Blend modes | absents du binding SDL | fillRect avec alpha (texture 1×1 translucide), PNG avec alpha, images pré-teintées |
| Shaders, 3D | pas d'OpenGL dans le binding | $engine->gl() (WebGL, navigateur seulement : api-web.md) |
| Onglet masqué | plus de frames (requestAnimationFrame s'arrête) |
lifecycle()->on('hide') est appelé tout de suite ; pause_scene dans project.yaml |
| Son | démarre après un geste de l'utilisateur | la page affiche « CLICK / TAP TO PLAY » une fois chargée |
| Quitter | une page ne se ferme pas | Engine::quit() → ?back=URL ou « THANKS FOR PLAYING » |
| Performances | ~2-4× plus lent que le natif | peu d'objets créés par frame, textures en cache, FixedStep raisonnable |
| Démarrage | chargement du moteur (7,5 Mo, en cache ensuite) + du jeu | assets légers, textures chargées à la demande (registerTexture + groupes) |
PHP_OS vaut Linux aussi dans le navigateur : utiliser Platform::isWasm().
Déboguer
bin/jumphp webshot <jeu> 6 '[[1,"Enter"]]': charge la page dans un Chrome sans écran, affiche la console, échoue sur une erreur PHP / JS, capturedist/webshot.png.- La console du navigateur reçoit
stdout/stderrde PHP. Une exception pendant le jeu affiche un écran rouge « CRASH » avec le message, le fichier et la ligne. ?debug=1dans l'URL : overlay FPS (F3 aussi).- Les messages
munmap() failedd'emscripten sont filtrés (sans conséquence).