sonicGameSite

Le site de Sonic PHP, en ligne sur https://sonic.mimichat.fr :

• un gros bouton JOUER, qui ouvre le jeu (https://sonic.mimichat.fr/jeu/). Si on est connecté, le jeu reçoit le nom du compte (?name=) et l'utilise dans les salons en ligne ;
• une inscription rapide : un nom de joueur (3 à 15 lettres ou chiffres, comme dans le jeu), un mot de passe, un email facultatif. Pas de mail de confirmation pour le moment. L'accueil montre le nombre de membres ;
• connecté, l'accueil devient le hall des salons : les salons publics du jeu (rafraîchis toutes les 5 secondes), créer un salon public ou privé (mode et zone, niveaux bonus compris), rejoindre un salon par son code ;
• la page d'un salon (/salon/CODE) : qui est dans le jeu, qui est sur le site, la discussion (la même que dans les menus du jeu), le mode et la zone. JOUER ouvre le jeu directement dans le salon ; après le match, le jeu revient sur cette page. Partager passe par la feuille de partage du téléphone, sinon le lien est copié. Les Sonic du fond sont ceux du salon ;
• l'onglet Statistiques : temps de jeu (seul, en ligne, contre l'ordinateur), sauts, anneaux, ennemis, ressorts, vies perdues, actes, émeraudes, matchs et victoires, et le classement de ceux qui jouent le plus ;
• il faut un compte pour jouer (toutes les parties et les statistiques sont enregistrées) : sans compte, JOUER (/jouer, un niveau du site, la page d'un salon) mène à l'inscription (ou à la connexion), puis revient directement au jeu ou dans le salon (?next=). La page du jeu, ouverte sans le jeton d'un compte (?st=, vérifié avec POST /api/stats), renvoie ici ; pas pour revoir un replay, ni dans une régie de live (?tap=0) ;
• la liste des joueurs inscrits (/joueurs, 30 par page), et la page de chacun (/joueur/{nom}) : ses créations, celles auxquelles il participe, ses dernières actions, ses parties (/historique?joueur={nom}) ;
• le nombre de joueurs dans le jeu dans l'en-tête de chaque page : les jeux ouverts (la page du jeu le dit au site toutes les 45 secondes, POST /api/jeu, gardé 2 minutes en cache), au moins les joueurs des salons du relais ;
• le référencement : description, Open Graph et Twitter sur chaque page, avec l'image public/img/og-fr.png / og-en.png (refaite par tools/og-image.py tools/og-background.png <jeu>) ; robots.txt, /sitemap.xml. Un lien de salon partagé porte ?lang= : l'aperçu est dans la langue de celui qui partage ;
• le site en français ou en anglais : la langue du navigateur, ou FR / EN dans l'en-tête (cookie lang). Le jeu suit la langue du site (?lang=) ;
• les visiteurs en direct : un Sonic par personne sur le site, sur le fond de la page, chacun avec son comportement (coureur, sauteur, spin dash, flâneur, suiveur). Le sien est bleu, marqué « TOI », et court après la souris (sur téléphone : là où on touche l'écran). Les nuages sont ceux de Green Hill ;
• les éditeurs : niveaux, tiles (dessin et collisions), sprites, sons et musiques, publics ou privés. Les niveaux se jouent dans le jeu (bouton Jouer, ou menu NIVEAUX DU SITE du jeu). Ce qui reste à faire est dans TODO.md.

Symfony 8.1, PHP 8.4, MariaDB 11.4, FrankenPHP (avec son hub Mercure). Pas de framework JavaScript : un seul script, public/js/sonics.js.

Comment marchent les visiteurs en direct

Le hub Mercure de FrankenPHP (docker/Caddyfile) a l'option subscriptions : il annonce lui-même chaque abonnement qui s'ouvre ou se ferme.

1. La page appelle /presence (PresenceController). Le site lui donne un cookie signé, valable une heure, qui l'autorise à s'abonner au sujet urn:sonicphp:presence, et à voir qui d'autre y est abonné.
2. La page s'abonne à ce sujet. Elle reçoit aussi les arrivées et les départs, et demande la liste de départ à l'API du hub.
3. Une personne = une page ouverte. Chaque abonnement porte le nom du compte (ou rien), affiché au-dessus du Sonic.

Rien n'est publié et le hub ne garde aucun historique (transport local : pas de base sur disque).

Comment marchent les salons

La page d'un salon (public/js/room.js) se connecte au relais du jeu (RELAY_WS_URL) comme spectateur (voir le guide de php-wasm-network) : elle voit les joueurs, la discussion et le match, sans jouer. Elle parle le protocole du jeu (Online.php de sonicGamePhp) : HELLO pour dire son nom, CHAT pour la discussion, et SITE (type 8, entre pages du site seulement) pour le mode et la zone choisis tant que personne n'est dans le jeu. Un salon créé ici l'est par la page (create avec watch) ; le premier joueur qui arrive du jeu en devient l'hôte. Le relais garde un salon vide 90 secondes : le temps que le jeu se charge.

JOUER ouvre le jeu avec ?room=CODE&mode=…&level=…&back=<page du salon> en plus du nom, de la langue et du jeton des statistiques. La zone peut être un niveau de l'éditeur (les siens et les publics) : level=36 et sl=<id>&slt=<clé>&sln=<nom> ; le jeu le télécharge avant le match, les autres joueurs aussi (le nom est dans les infos du salon, site). La liste des salons publics vient de GET /health?rooms du relais (OnlineStats, /salons.json).

Comment marchent les statistiques

Le jeu compte dans var/stats.json (dans le navigateur : IndexedDB). JOUER donne à la page du jeu un jeton st (l'id du compte signé avec APP_SECRET, StatsToken) et l'adresse du site (site). La page garde le jeton, puis envoie chaque minute, et à la fermeture, ce qui a été gagné depuis le dernier envoi : POST /api/stats en text/plain (pas de requête CORS préalable ; sendBeacon à la fermeture). Le site plafonne chaque envoi et en limite le nombre (240 par heure et par compte).

Comment marchent les éditeurs

• /editeur : mes niveaux, mes tiles, mes sprites, les niveaux publics, les tiles (les zones du jeu et celles des joueurs) et les sprites publics. Un niveau public se regarde sans compte (/niveau/{id}, image /niveau/{id}.png pour les liens). L'édition demande un ordinateur : sur un téléphone, la page le dit et ne montre que la vue.
• Un niveau a le format du jeu : largeur × hauteur blocs de 32 px, un octet par bloc (un bloc de son jeu de tiles), le départ de Sonic et les objets ([type, x, y] en blocs, types de EditorData::OBJECTS, ceux des level<N>.objects.php du jeu), sa musique et, s'il en a, son jeu de sprites. Le jeu le télécharge par /niveau/{id}/jeu.json (un niveau privé avec la clé lt de LevelToken) : bouton Jouer / Tester, ou son menu NIVEAUX DU SITE, qui lit POST /api/niveaux (les niveaux publics, et les siens avec le compte du joueur).
• Dans l'éditeur de niveau, les objets sont dessinés avec leur sprite du jeu : public/img/objects.png et public/data/object-icons.json, refaits par DISPLAY=:77 python3 tools/object-icons.py <jeu> (le jeu natif dans un écran X, en mode SONIC_OBJECT_ICONS).
• Un jeu de tiles : jusqu'à 256 blocs, 16 par ligne dans un PNG, et un octet de collision par bloc (comme level<N>.solidity : les 6 bits du bas sont une des 47 formes de public/data/solidity-shapes.json, le bit 7 dessine le bloc devant Sonic). On peut copier ceux des autres s'ils sont publics. Un jeu utilisé par un niveau ne peut pas être supprimé, et seul son dernier bloc peut être enlevé (les niveaux visent les blocs par leur numéro). La zone rouge (collision) d'un bloc peut aussi être dessinée au pixel, avec ses côtés (sol, murs, plafond) : tileset.masks, appliqué par le jeu (Level::applyMask). Un bloc peut être animé (cascade, eau, lave) : il montre tour à tour les images d'autres blocs, chacune t images du jeu (60 par seconde) : tileset.animations ({bloc: {f: [blocs], t}}), dessiné par le jeu (Level::animatedBlock, Scene::drawTiles), réglé dans l'éditeur (Maj+clic) ou par MCP (animate). Un niveau fait avec une zone du jeu (ou un fork dont l'image n'a pas changé) envoie zone dans jeu.json : le jeu prend alors les images de la zone et ses cycles de couleurs (l'eau du Jungle...). Un fork modifié garde ces cycles : TileVariants recolore son image comme le jeu recolore la zone d'origine (les correspondances de couleurs de chaque image du jeu, -cycleK, -lightL-cycleK des éclairs de Sky Base, -flash, -water, calculées par tools/game-data.py dans data/game/zone-*.json) ; jeu.json envoie cycle (count, speed, lightning) et tile_variants ({"-cycle0": PNG en base64...}, gardés en cache par image dans var/cache/*/tile-variants).
• La ligne d'eau (objet 64, celui du Labyrinth) se place dans tout niveau : tout passe sous l'eau en dessous (air, bulles, palette). Sans zone Labyrinth d'origine, l'image -water est une teinte sous-marine générique (TileVariants::underwater).
• Un jeu de sprites (SpriteSet, éditeur /sprites/{id}/editer) : des planches du jeu redessinées (Sonic, badniks, objets, boss…, SpriteSet::SHEETS), chacune un PNG de la taille de celle du jeu, transparent là où le jeu a sa couleur de transparence. Un niveau qui le choisit se joue avec : le jeu met ces planches à la place des siennes pendant le niveau (LevelManager::loadCustom). Les planches de départ sont public/img/sheets/, refaites par python3 tools/sprite-sheets.py <jeu>.
• Les zones du jeu (blocs, collisions, l'acte 1 de chacune comme modèle) sont dans data/game/, refaites par python3 tools/game-data.py <jeu>. bin/console app:zones les met en base (lancé au démarrage du conteneur).
• Un son (Sound, /son/{id}/editer) : une musique (un piano roll sur les 4 voix de la puce de la Master System : 2 carrés, une basse, le bruit pour la batterie ; une voix joue une note à la fois) ou un bruitage (les réglages d'un générateur : onde, hauteur qui glisse, enveloppe, vibrato, répétitions). Le format est décrit dans SoundData. public/js/sound-engine.js les joue (Web Audio) et en fait des WAV. À l'enregistrement, l'éditeur envoie aussi le son rendu (WAV 22050 Hz, une boucle pour une musique ; SoundAudio) : c'est ce que joue le jeu. Un niveau choisit une musique du jeu ou une de l'éditeur de sons, et peut remplacer des bruitages du jeu (SoundData::GAME_SFX) ; /niveau/{id}/jeu.json les donne en WAV (music_wav, sfx_wav).
• Outil clone (K) dans les éditeurs de niveau, de tiles et de sprites : Alt+clic (ou clic droit) sur la source, puis on peint ailleurs ; la source, encadrée en bleu, suit le pinceau. Dans l'éditeur de tiles, la source peut être dans un autre bloc (Alt+clic sur la liste des blocs).
• Un replay sur un niveau de l'éditeur (niveau 36) est relié à ce niveau (replay.site_level_id) : son nom dans l'historique ; « Revoir » le télécharge d'abord.
• Compteur de visiteurs en bas des pages (depuis le 24/10/2026) : une visite compte quand le JavaScript de la page l'envoie (public/js/visit.js, POST /api/visit avec l'en-tête X-Sonic-Visit), pas pour les robots (agent utilisateur, navigateur piloté), et une seule fois par adresse IP. Les adresses ne sont pas gardées : un hachage à clé (VisitorCounter, table visitor). Il faut l'adresse réelle du visiteur (le proxy Cloudflare devant le domaine, voir plus bas) : une adresse privée (celle de Traefik) ne compte pas.
• « Revoir » rejoue la partie telle qu'elle a été jouée : les Sonic aux positions enregistrées, et les objets de l'acte (boss, panneau de fin, capsule, badniks, moniteurs) qui réagissent au Sonic du joueur comme pendant la partie, avec le HUD. Pour un match : ligne d'arrivée, bases, drapeau, scores et messages. Le format est décrit dans ReplayRecorder.php (jeu) ; les anciens replays restent lisibles.
• En local, le site vise par défaut le relais de prod (.env) : pour tester les salons, mettre RELAY_WS_URL, RELAY_HEALTH_URL et GAME_URL sur le relais et la page locaux dans .env.local.
• Les éditeurs (public/js/level-view.js, editor-level.js, editor-tiles.js, editor-sprites.js, editor-music.js, editor-sfx.js) enregistrent en JSON avec le jeton CSRF editor (en-tête X-CSRF-Token) ; EditorData vérifie tout ce qu'ils envoient.

Comment marchent les notes, les favoris et le catalogue des niveaux

• /niveaux (LevelsController) : tous les niveaux publics, triés (?tri=top les mieux notés, new, plays, fav les plus souvent en favoris), cherchés (?q= : nom du niveau ou du joueur), 24 par page ; ?vue=favoris et ?vue=miens pour le joueur connecté. Le hub de l'éditeur n'en montre que les 8 mieux notés.
• Un joueur connecté donne 1 à 5 étoiles à un niveau public d'un autre (LevelVote, un vote par joueur, modifiable), et met n'importe quel niveau qu'il voit dans ses favoris (LevelFavourite), sur la page du niveau, avec le cœur des cartes, ou dans le jeu (page TON AVIS à la fin d'un niveau de la liste).
• Level garde les totaux pour trier sans calcul : voteCount, voteSum, favourites, plays et score (LevelRatings::score : la moyenne ramenée vers 3 comme s'il avait 4 votes de 3 de plus ; un seul 5 ne passe pas devant tout le monde). Une partie compte quand le jeu télécharge jeu.json, une fois toutes les 6 heures par adresse (cache cache.app).
• Le jeu : POST /api/niveaux prend sort (top, new, plays, fav, mine, favourites ; sans sort, l'ancien ordre) et donne rating, votes, plays, favourites, stars et fav de chaque niveau ; POST /api/niveaux/note ({st, id, stars?, fav?}, en text/plain) enregistre l'avis du joueur.
• API publique : rating, votes, score, plays, favourites dans /levels, order=top|plays|favourites. MCP : list_creations (sort, search, scope favourites). L'API et le MCP ne votent pas.

Comment marchent les meilleurs temps des niveaux

• Quand un joueur connecté termine seul un niveau du site, la page du jeu envoie son replay (POST /api/replay) avec time (le chrono du jeu) et site.version (la version du niveau joué, Level::getContentVersion : ses blocs, son départ, ses objets, ses tiles). LevelRecords garde son meilleur temps (LevelRecord, un par joueur et par version) et le replay qui va avec : ReplayRepository::keepLatest ne l'efface pas.
• Le classement repart de zéro quand le créateur change les blocs ou les objets (pas pour un nouveau nom).
• La page du niveau montre les 10 meilleurs (avec « Revoir »), l'API publique bestTimes, et jeu.json les 5 meilleurs (records) et version. Le jeu affiche le record au début du niveau et télécharge son replay (/api/replay/{id}, record.json.gz) : son fantôme court avec le joueur (option Fantôme) s'il est plus rapide que le sien. Les fantômes du joueur sont gardés par niveau et par version (site<id>-<version>).
• Les temps viennent du jeu, sans contrôle côté serveur : un joueur qui trafique sa page peut tricher.

Comment marchent les forks, le travail à plusieurs et l'historique

• Chaque création (niveau, tiles, sprites, son) montre son créateur, avec un lien vers sa page, et sous la page de la création, ses crédits (templates/_parts/credits.html.twig) : d'où elle vient, ses forks, les joueurs qui la modifient, le lien vers son historique. Dans le jeu, un niveau du site affiche son nom et son auteur pendant ses 4 premières secondes (Game::drawSiteCredit, author de jeu.json).

• Forker : faire sa propre copie d'une création visible (forked_from_id la relie à l'originale ; l'historique des deux le dit). Un son forké garde le son rendu de l'original (SoundAudio) jusqu'à son premier enregistrement ; ses cartes, sa page et son éditeur disent de quel son il est le fork.

• À plusieurs : le créateur ajoute des joueurs par leur nom (Member, POST /creation/{sorte}/{id}/membres). Ils ouvrent l'éditeur et enregistrent comme lui (pas de suppression, pas d'ajout de joueurs). Les créations partagées sont dans /editeur (« Partagés avec moi »). Un éditeur ouvert demande toutes les 5 secondes (public/js/editor-live.js, POST /api/edition/{sorte}/{id}) la version enregistrée et qui d'autre est dans l'éditeur (cache, 15 s). Il dit quand quelqu'un d'autre a enregistré. Chaque enregistrement envoie la version dont l'éditeur est parti : si quelqu'un a enregistré depuis, le site répond 409, et le joueur choisit de recharger ou d'écraser (force ; l'autre version reste dans l'historique).

• Corbeille (/corbeille, Trashable) : supprimer une création la met dans la corbeille de son créateur (trashed_at). Personne d'autre ne la voit, on ne peut plus la mettre dans un nouveau niveau ; les niveaux déjà faits avec la gardent, ses forks restent. Le créateur la restaure ou la supprime pour de bon (des tiles qui servent encore à des niveaux ne peuvent pas l'être). Au bout de 30 jours, app:trash (au démarrage du conteneur, et à l'ouverture d'une corbeille) la supprime pour de bon ; son historique reste. On y met une création par la poubelle rouge de sa carte (éditeur, profil : seulement son créateur, avec une confirmation ; TrashRedirect revient sur la page avec un lien pour la restaurer) ou par le bouton de sa page.

• Historique complet (Revision, /niveau|tiles|sprites|son/{id}/historique) : chaque action (création, fork, enregistrement, version reprise, joueur ajouté ou retiré, suppression), qui, quand, ce qui a changé en mots (Creations::changes : blocs, objets, dessin des blocs lu dans le PNG par Png, notes…) et, pour chaque version, tout son contenu (JSON compressé). « Ouvrir cette version » la charge dans l'éditeur (?version=) ; l'enregistrer la reprend. L'historique reste visible après une suppression pour ceux qui y ont travaillé. bin/console app:history (au démarrage du conteneur) donne une première version aux créations faites avant l'historique.

• La corbeille garde 30 jours (Creations::TRASH_DAYS) ; après, tout est supprimé pour de bon : au démarrage du conteneur (app:trash), à l'ouverture d'une corbeille, et une fois par jour après la première requête du jour (TrashPurgeSubscriber, sans cron).

Comment marche le serveur MCP (créer avec une IA)

Une IA connectée au compte d'un joueur crée tout un environnement de jeu : tiles, niveau, sprites, musique, bruitages. Elle le regarde, le teste et le publie. La page /ia (publique) explique comment la brancher.

• Clés (ApiKey, page /ia/cles, menu « IA et clés API ») :
  • sk_sonic_ + 40 caractères aléatoires ; seul le SHA-256 est gardé ;
  • la clé n'est montrée qu'une fois ;
  • lecture seule, ou lecture et écriture ;
  • durée de 30, 90 ou 365 jours, ou sans fin ;
  • 10 clés au plus par joueur ;
  • l'auteur la supprime quand il veut.
• Authentification : ApiKeyAuthenticator, firewall api, sans état et sans cookie, sur ^/(mcp|api/v1). La clé passe par Authorization: Bearer ou X-Api-Key. Sans clé, ou avec une clé inconnue ou expirée : réponse 401 en JSON.
• POST /mcp (McpController) :
  • MCP en JSON-RPC 2.0, transport « Streamable HTTP », réponses JSON, sans session ;
  • méthodes initialize, ping, tools/list, tools/call ; les notifications renvoient 202 ;
  • GET renvoie 405 ;
  • un Origin d'un autre site renvoie 403 ;
  • corps limité à 8 Mo.
• API REST (ApiController) :
  • GET /api/v1 donne la liste des outils avec leurs schémas ;
  • GET /api/v1/openapi.json ;
  • POST /api/v1/{outil} renvoie {ok, data, images}.
• Les outils (src/Service/Studio) :
  • ToolRegistry rassemble les ToolProvider : AccountTools, LevelTools, TilesetTools, SpriteTools, SoundTools, soit 24 outils.
  • Il refuse l'écriture à une clé en lecture seule.
  • Limites par clé : 240 appels par 10 minutes (api), dont 60 rendus ou tests (api_heavy).
  • Une erreur de l'IA revient en ToolError, avec un message clair (isError en MCP, 400 en REST).
  • Les modifications passent par Creations : historique, membres, corbeille. L'historique note « Par l'API, clé … ».
  • Rien n'est supprimé pour de bon par l'API (corbeille seulement).
  • Une création d'un autre joueur ne se modifie pas : il faut la forker.
• Ce qui sert à l'IA :
  • Reference : le mode d'emploi (formats, physique, formes, objets, musique) ;
  • LevelRenderer : l'image du niveau, aussi en miniature ;
  • Simulator : la « fausse partie », un robot avec la physique du jeu (test_level) ;
  • SoundRenderer : le portage PHP de sound-engine.js, qui fait les WAV de SoundAudio ;
  • Canvas, Pixels et Png::encode : le pixel art en texte vers PNG, et l'inverse (il n'y a pas GD).

Comment marche l'API publique (lecture seule)

Tout ce qu'un visiteur non connecté voit sur le site, en JSON, sans compte et sans clé. Elle est faite avec API Platform 5. La page /developpeurs la présente. La doc est sur /api/public/docs : Swagger UI, et aussi ReDoc (?ui=re_doc), Scalar (?ui=scalar) et docs.jsonopenapi (OpenAPI 3.2).

• DTO (src/ApiResource) :

  • Level, LevelMap (/levels/{id}/map) ;
  • Tileset, TilesetBlocks ;
  • SpriteSet, Sound ;
  • Player, Replay, HistoryEntry.

  Ce sont des DTO, jamais les entités : l'intégration Doctrine d'API Platform est désactivée. Chaque champ, paramètre et opération a sa description et ses exemples. Les liens entre ressources sont des IRI.

• Providers (src/State/PublicApi) : PublicView convertit les entités en DTO. La seule règle est Creations::canSee($creation, null), c'est-à-dire ce qu'un visiteur voit. Les listes ne donnent que le public (plus les zones pour les tiles). Une partie privée d'un niveau public n'est liée que si le site la montre : ses tiles et ses sprites oui, une musique privée non.

• Ce qui n'est jamais donné :

  • ni l'e-mail ;
  • ni les statistiques privées ;
  • ni les créations privées ou dans une corbeille ;
  • ni la clé lt d'un niveau privé ;
  • ni le nom des clés API dans l'historique (« Par l'API » seulement ; la page historique du site le cache aussi à ceux qui ne peuvent pas modifier la création).

• Firewall public_api (security: false) : sans session ni cookie.

• PublicApiSubscriber :

  • CORS ouvert (*, GET) ;
  • limite par IP (limiter.public_api, seau à jetons : 600 d'un coup, puis 1 par seconde ; 429 avec Retry-After) ;
  • en-têtes X-RateLimit-*.

  La doc n'est pas comptée.

• App\OpenApi\PublicApiDocs décore la fabrique OpenAPI : description générale, tags documentés, lien vers /developpeurs, pagination expliquée. NoSecurityNormalizer enlève les securitySchemes vides (sinon Swagger UI affiche un bouton « Authorize »).

• Paramètres : QueryParameter avec contraintes. Une valeur invalide renvoie 422 en Problem Details.

Développer

composer install
# une MariaDB de développement
docker run -d --name sonic-mariadb-dev -p 127.0.0.1:13306:3306 \
  -e MARIADB_DATABASE=sonic -e MARIADB_USER=sonic -e MARIADB_PASSWORD=devpass \
  -e MARIADB_RANDOM_ROOT_PASSWORD=1 mariadb:11.4
cat > .env.local <<EOF
APP_SECRET=$(openssl rand -hex 16)
DATABASE_URL="mysql://sonic:devpass@127.0.0.1:13306/sonic?serverVersion=11.4.13-MariaDB&charset=utf8mb4"
EOF
php bin/console doctrine:migrations:migrate -n
php -S 127.0.0.1:8000 -t public          # le site, sans les visiteurs en direct (pas de hub Mercure)

Pour tout avoir, hub Mercure compris, lancer l'image de production en local :

docker build -t sonic-site:dev .
docker run --rm --network host \
  -e APP_SECRET=$(openssl rand -hex 16) \
  -e "DATABASE_URL=mysql://sonic:devpass@127.0.0.1:13306/sonic?serverVersion=11.4.13-MariaDB&charset=utf8mb4" \
  -e MERCURE_JWT_SECRET=$(openssl rand -base64 32) \
  -e MERCURE_PUBLIC_URL=http://127.0.0.1:8080/.well-known/mercure -e MERCURE_COOKIE_NAME=mercure_access_token \
  sonic-site:dev                         # http://127.0.0.1:8080/

Pour tester les salons en local : le relais (php server/bin/server.php dans php-wasm-network) et la page du jeu (./serve.sh root 8080 dans php-wasm-sdl), puis dans .env.local :

RELAY_HEALTH_URL=http://127.0.0.1:8090/health
RELAY_WS_URL=ws://127.0.0.1:8090/ws
GAME_URL=http://127.0.0.1:8080/?net=ws://127.0.0.1:8090/ws

Après un test, effacer les comptes créés (delete from user, les statistiques partent avec) : la base de production doit rester propre.

La limite d'inscriptions (10 par heure et par adresse) se remet à zéro avec php bin/console cache:pool:clear cache.rate_limiter.

Les images public/img/ viennent du jeu. Elles sont refaites par les scripts de tools/ (le chemin du jeu est donné en argument). Après une modification d'un fichier de public/, monter framework.assets.version (config/packages/framework.yaml) : ces fichiers sont gardés une heure en cache.

Variables

Variable	Rôle
APP_SECRET	secret de Symfony (sessions, « se souvenir de moi »)
DATABASE_URL	la base MariaDB
GAME_URL	l'adresse du jeu, ouverte par JOUER
RELAY_HEALTH_URL	/health du serveur multijoueur : joueurs et salons publics, affichés sur l'accueil
RELAY_WS_URL	le WebSocket du serveur multijoueur, vu du navigateur (pages des salons)
TRUSTED_PROXIES	les proxys dont on croit X-Forwarded-For (en production : PRIVATE_SUBNETS, le Caddy de devant)
MERCURE_PUBLIC_URL	l'adresse du hub vue du navigateur (https://<domaine>/.well-known/mercure)
MERCURE_JWT_SECRET, MERCURE_JWT_ISSUER	la signature des cookies du hub (les mêmes pour le site et le hub)
MERCURE_COOKIE_NAME	__Secure-mercure_access_token en HTTPS, sans préfixe en HTTP local

Production

Le site tourne sur le VPS avec le serveur multijoueur, dans /mimichatPROD/sonicGameServerPhp. Les fichiers de déploiement sont dans php-wasm-network/server/deploy-traefik :

• conteneurs site (ce dépôt, cloné dans sonicGameSite/) et db (MariaDB, sur un réseau où seul le site la voit) ;
• le Caddy de devant fait le HTTPS. Il envoie /ws et /health au relais, et tout le reste au site ;
• l'adresse réelle des visiteurs vient du proxy Cloudflare (CF-Connecting-IP, lue par Caddy, puis passée au site dans X-Forwarded-For). Elle sert à la limite d'inscriptions et à celle des essais de connexion. Sans Cloudflare, tout le monde aurait l'adresse de Traefik : il passe le TLS tel quel ;
• les secrets (SITE_APP_SECRET, SITE_MERCURE_SECRET, SITE_DB_PASSWORD, SITE_DB_ROOT_PASSWORD) sont dans le .env du serveur, jamais dans Git.

cd /mimichatPROD/sonicGameServerPhp
./update-site.sh                         # nouvelle version du site (migrations jouées au démarrage)
docker compose logs -f site
# sauvegarde de la base
docker compose exec -T db sh -c 'mariadb-dump -usonic -p"$MARIADB_PASSWORD" sonic' | gzip > backup/sonic-$(date +%F).sql.gz