winzik/docs/ide.fr.md
David Nurdin e796498ed1 IDE: Symfony Forms window, a visual form builder for FormTypes
- The Symfony Forms window (projects requiring symfony/form): the project's FormTypes, New form type, twig.yaml's form themes.
- The form builder: fields added from Symfony's types and the project's own (sub-forms), reordered by dragging, removed; each
  type's options edited by kind (label, required, help, attr / row_attr, validator constraints with their options, choices,
  EntityType class / query_builder, CollectionType entry_type / allow_add / allow_delete / by_reference / prototype, RepeatedType,
  date widgets / html5...), configureOptions, form events (listener methods made), data transformers (classes made).
- Add fields from the class: an entity's / DTO's properties with suggested types (Doctrine columns, relations -> EntityType /
  CollectionType, enums, PHP types, names).
- Preview without PHP: the HTML of form_div_layout, form_table_layout, bootstrap_5_layout, tailwind_2_layout with Symfony's ids /
  names, sub-forms, collection prototypes and "Show errors", in the project's base.html.twig with its CSS.
- Round trip: FormTypes read back with php-parser (add() chains, option arrays, conditionals / closures kept locked) and written
  by text edits at php-parser's positions: only what changed, the rest byte for byte; new FormTypes as maker-bundle writes them.
- Generate the controller action (createForm, handleRequest, persist / flush or DTO, flash, redirect) into an existing or new
  controller and its Twig template; every change shown as a diff first.
- ide/src/Symfony/Form*.php + Imports.php (forms.* commands), ide/ui/js/symfony-forms*.js, css/symfony-forms.css; 14 languages.
- Tests: SymfonyFormsTest (exact generated code, parsing, byte-identical round trips, edits, suggestions, generators),
  symfony-forms-preview.test.mjs (HTML per theme), games/ide/tools/ui-forms-check.sh (screenshots); checked on a Symfony 8.1
  project (debug:form, GET renders the fields, invalid POST 422 with the message, valid POST 303 + flash).
- Docs: docs/ide/symfony-forms.md (+ fr), docs/ide.md.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01JkYTqsvYu6AYr9yQ3Q4Nt6
2026-11-16 00:35:45 +01:00

17 KiB
Raw Permalink Blame History

JumPHP IDE

English

Utiliser l'IDE : une page par fonctionnalité, avec captures, dans docs/ide/fr/ (anglais : docs/ide/) ; dans l'IDE, le bouton Doc en haut à droite (Aide > Documentation).

Un IDE pour les projets JumPHP (jeux, applications de bureau, jeux hybrides, remakes Amstrad CPC, portages), écrit en PHP, qui marche pareil en application native sur l'ordinateur et sur le web (jumphp.net/ide). Il édite vos vrais projets : vous vous connectez avec jumphp.net, il liste vos projets (vos dépôts Git), les clone et pousse vos commits.

  • ide/ : le paquet jumphp/ide, le cœur PHP (JumPHP\Ide\) et l'interface (HTML / CSS / JS avec Monaco, l'éditeur de VS Code) ; partagés par l'application de bureau et le site.
  • games/ide/ : l'application de bureau (Tauri, docs/tauri.fr.md).

Ce qu'il sait faire

  • Éditeur : onglets, découpage, diff, sauvegarde automatique, thèmes sombre et clair.
  • Intelligence PHP : complétion qui suit les types ($this->engine->config->, types de retour, @var, @property, @method), import automatique des use, aide aux paramètres, aller à la déclaration / aux implémentations, recherche des usages, renommage (classe, méthode, propriété, constante, variable ; une classe renomme son fichier), documentation au survol, structure du fichier, problèmes (erreurs de syntaxe, classes / méthodes / fonctions inconnues).
  • Navigation : Search Everywhere (double Maj), aller au fichier / à la classe / au symbole, fichiers récents, chercher / remplacer dans les fichiers, position précédente / suivante (Ctrl+Alt+Gauche / Droite, ou les boutons précédent / suivant de la souris).
  • Git : fenêtre Commit (modifications, cases à cocher, amend), diff avec HEAD, commit et push, mise à jour (pull), branches, stash, historique avec les fichiers de chaque commit, annotate (blame), annulation.
  • Exécution : les configurations du projet (bin/jumphp run / test / shot / build / webshot / serve / export / lint par jeu ou application), sortie en direct, liens fichier:ligne, résultats des tests en arbre, captures ouvertes dans un onglet.
  • Terminal (bureau) : Alt+F12 (View > Terminal), des shells dans le dossier du projet, un onglet chacun (+). Linux / macOS : ton shell ($SHELL) dans un pseudo-terminal (couleurs, invite, Ctrl+C, programmes plein écran, taille qui suit la fenêtre) ; les touches vont au shell (seules les Alt+… vont à l'IDE), copier / coller avec Ctrl+Maj+C / V. Windows : cmd.exe (JUMPHP_IDE_SHELL=powershell pour PowerShell) sur des tubes : la ligne est éditée dans l'IDE puis envoyée.
  • Base de données (bureau, barre de droite) : les bases MySQL / MariaDB et SQLite du projet (d'après jumphpsql) : connexions dans .jumphp/databases.json (jamais de mot de passe : gardé par l'IDE sur cet ordinateur si on le demande, sinon demandé), trouvées en un clic dans .env DATABASE_URL, les DB_* de Laravel, les services Docker Compose et le site web JumPHP ; arbre bases › tables, vues, routines › colonnes, index, clés étrangères ; consoles SQL dans l'éditeur (.jumphp/consoles/, hors de git ; Ctrl+Entrée exécute la requête sous le curseur, complétion des tables et colonnes du schéma réel) ; résultats paginés, triés, filtrés, exportés (CSV / JSON / SQL) ; lignes d'une table modifiées sur place (UPDATE / DELETE / INSERT montrés puis exécutés dans une transaction) ; tunnels SSH par les serveurs de la fenêtre SSH (jump host compris) ; une connexion production est rouge et demande confirmation avant toute écriture. Détails : Database.
  • Historique local (bureau) : File › Show Local History (aussi au clic droit d'un onglet ou d'un fichier de l'arbre) : les versions d'un fichier gardées par l'IDE sur cet ordinateur, sans git : une à chaque sauvegarde, et une quand le fichier a changé hors de l'IDE (Claude Code, un terminal, git) avant que l'IDE le sauve ou le rouvre. Compare (un diff dont la droite est le fichier, modifiable) ou Revert (un seul changement dans l'éditeur : Ctrl+Z le défait). Gardé dans .jumphp/history/files/ (hors de git) : les 60 dernières versions de chaque fichier, 60 jours au plus, fichiers texte jusqu'à 1 Mo.
  • Débogueur (bureau) : Xdebug. Un clic dans la marge à gauche d'une ligne PHP pose un point d'arrêt (clic droit : une condition, Ctrl+F8 au curseur) ; Debug (Maj+F9, l'insecte à côté de Run) lance la configuration choisie avec Xdebug (JUMPHP_XDEBUG). À l'arrêt : la ligne marquée, la fenêtre Debug avec la pile, les variables en arbre, des expressions surveillées ou évaluées, une variable changée (double clic ou F2 : une expression PHP) ; Reprendre F9, pas à pas F8, entrer F7, sortir Maj+F8, exécuter jusqu'au curseur Alt+F9, Stop. Stop at Exceptions… (le ⚠ de la fenêtre Debug) : * ou des noms de classes, il s'arrête là où l'une est lancée, attrapée ou non, et dit laquelle avec son message. Claude s'en sert aussi (outils debug_*) : vous le voyez poser ses points d'arrêt et avancer dans le code. Depuis un terminal : claude mcp add jumphp-debug -- bin/jumphp debug (le même débogueur en serveur MCP ; Claude lance le programme avec JUMPHP_XDEBUG=9003, puis debug_wait).
  • Éditeur visuel HTML / CSS : les fichiers .html en Code / Split / Design (composants à glisser, calques, inspecteur, règles CSS des feuilles liées, tailles d'écran) ; le HTML reste tel qu'écrit. Pour les pages des applications de bureau et les sites des jeux.
  • Plugins (bureau) : des plugins en PHP (docs/ide-plugins.md) ajoutent des actions (menus, Find Action, raccourcis), des fenêtres d'outils, des configurations d'exécution, de la complétion et des problèmes pour les fichiers qu'ils choisissent, et des outils pour Claude sur le serveur MCP de l'IDE (mcp__jumphp-ide__plugin_<id>_<nom>). Tools › Plugins… les installe (un dossier, les plugins du projet, jumphp.net/ide-plugins), les met à jour, les active, les retire, et publie ceux du projet sur jumphp.net ; bin/jumphp plugin:new en crée un, testé sans fenêtre (PluginTestCase).
  • Claude (bureau) : la fenêtre Claude (Alt+8) parle au Claude Code de l'ordinateur. Suivre (l'œil, actif par
    • Pas à pas : le mode Step by step de la fenêtre (Maj+Tab ou menu ⚙). Claude Code demande à l'IDE avant chaque Edit / MultiEdit / Write et rien n'est écrit avant votre réponse : le fichier s'ouvre à la modification, ce que Claude retire est en rouge, ce qu'il ajoute en vert dessous, chaque bloc avec sa case. La carte de l'étape (dans la conversation, avec la demande qui l'a provoquée) a un champ de message (« pas comme ça : … », envoyé à Claude avec le refus), Accept / Decline, puis See the diff et Roll back : chaque étape s'annule seule, ce qui est venu après reste. Les commandes et pages web gardent leur boîte de dialogue. défaut) : l'IDE montre ce que fait Claude au moment où il le fait : le fichier lu s'ouvre aux lignes lues (bleu), ce qu'une modification remplace est marqué avant (orange) et ce qu'il a écrit après (vert), ses commandes apparaissent dans Run avec leur sortie, ses recherches dans Find, son plan au-dessus de la conversation ; le clavier reste dans la fenêtre Claude et rien ne bouge pendant que vous tapez.
  • Claude : modes et autorisations : un sélecteur (et Maj+Tab dans la zone de saisie) choisit ce que Claude peut faire : mode auto, modifier les fichiers, plan seulement, demander, tout automatique ; le changement garde la conversation (--resume). Quand Claude demande une autorisation, la fenêtre propose : une fois, 5 min, 15 min, 1 h, la session ou toujours, pour ce genre de commande ou pour tout (⚙ > Forget the permissions given efface tout). Quand le contexte est plein à 80 %, l'IDE envoie /compact ; les jauges Context / 5 h / Semaine bougent en temps réel. Avec OpenCode, ses permissions suivent le mode (il ne peut pas demander : sans cela il refuse les outils MCP).
  • Historique des IA (IA/HISTORY) : chaque tour de Claude ou d'OpenCode est écrit à la racine du projet, IA/HISTORY/<CLAUDE|OPEN CODE>/<modèle>/<jj-mm-aaaa HH-MM-SS>/<demande>.md (la demande, les outils, la réponse). IA/ est ajouté au .gitignore : ce dossier n'est jamais envoyé à git et reste sur cet ordinateur, donc perdu avec lui. Hors de l'IDE, AGENTS.md (règle 12) demande la même chose aux IA.
  • Programmes manquants : quand git, Docker, Claude Code ou OpenCode ne sont pas installés, la notification d'erreur a un bouton Install (winget sous Windows, Homebrew sous macOS, le gestionnaire de paquets avec pkexec sous Linux, sinon la page de téléchargement). Créer le dépôt Git : si Git refuse le jeton (« Bad credentials »), un bouton Sign in again relance la connexion puis la création.
  • Claude : onglets, fenêtres, historique : un onglet par conversation ; + en démarre une autre sans arrêter les autres (chacune son processus Claude Code). Clic droit sur un onglet : Open in a Window (la conversation continue dans sa propre fenêtre ; fermer cette fenêtre la remet en onglet), renommer, copier en Markdown, fermer. Chaque conversation est gardée dans le projet, .jumphp/history/claude/<id>.json (un .gitignore garde .jumphp/history/ hors de git) : l'onglet History les liste, la plus récente d'abord ; un clic la rouvre dans un onglet et elle reprend où elle en était (--resume).
  • Claude pilote l'IDE : l'IDE donne au Claude qu'il lance ses propres outils (serveur MCP jumphp-ide sur 127.0.0.1, jeton aléatoire) : ouvrir un fichier, pointer des lignes avec une note, montrer un diff ou une fenêtre, lancer une configuration dans Run et lire son résultat, jouer une scène, les problèmes d'un fichier, ce que vous regardez (fichiers ouverts, curseur, sélection), vous poser une question, une notification. Détails : docs/ide.md (« The IDE's tools for an AI »).
  • Projets : connexion jumphp.net, vos projets, clonage, ouvrir un dossier, cloner un dépôt, Nouveau projet : jeu, application de bureau, jeu hybride, remake Amstrad CPC (le .dsk reste sur l'ordinateur), portage d'un jeu libre.

Les raccourcis de PhpStorm (Aide > Raccourcis clavier).

Formulaires Symfony

Une fenêtre des projets Symfony qui utilisent les formulaires (leur composer.json demande symfony/form, ou ils ont src/Form/), dans la barre d'outils de droite et dans Tools (Symfony Forms, Open the Form Builder on This File, New Symfony Form Type…). Elle liste les FormTypes du projet et les thèmes de formulaire de config/packages/twig.yaml ; un clic ouvre le constructeur de formulaire :

  • Champs : ajoutés depuis la liste des types de Symfony (groupés comme sa référence) et des types du projet (sous-formulaires), réordonnés par glisser-déposer, supprimés. Ajouter des champs depuis la classe… propose les propriétés de l'entité / du DTO avec le type suggéré (type de colonne Doctrine, relations → EntityType / CollectionType, type PHP, nom : email, password, prix…).
  • Inspecteur : les options du type, éditées selon leur nature (label, required, help, attr, row_attr, contraintes du validateur avec leurs options, choices, class et query_builder d'un EntityType, entry_type / allow_add / allow_delete / by_reference / prototype d'une CollectionType, widget / input / html5 des dates…), configureOptions (data_class, validation_groups, csrf…), les événements (méthode d'écoute créée) et les transformateurs de données (classe créée).
  • Aperçu : le HTML du thème (form_div_layout, form_table_layout, bootstrap_5_layout, tailwind_2_layout) produit sans PHP, dans la page du projet (base.html.twig et ses CSS), avec Afficher les erreurs.
  • Enregistrer… réécrit seulement ce qui a changé (php-parser, le reste du fichier octet pour octet ; ce qui est dans un if ou utilise des closures est verrouillé), un diff d'abord. Générer le contrôleur et le template… : l'action (createForm, handleRequest, isSubmitted && isValid, persist / flush ou DTO, flash, redirection) dans un contrôleur existant ou nouveau et son template Twig, en diff.

Page utilisateur : docs/ide/fr/symfony-forms.md ; détails techniques, tests et limites : la section « Symfony Forms » de docs/ide.md.

Commandes

bin/jumphp install ide           # composer install (et Monaco dans ide/ui/vendor/)
bin/jumphp app:test ide          # php -l, phpstan, phpunit, l'application en vrai sur Xvfb
bin/jumphp app:export ide        # games/ide/dist/standalone/ide-linux-x86_64 : l'IDE en un exécutable
bin/jumphp app:run ide           # pour l'essayer dans Docker (n'y voit que le dépôt JumPHP, sans Docker)

Pour travailler sur vos projets, utilisez l'exécutable exporté : il tourne sur votre ordinateur, avec votre git et votre Docker (nécessaire, comme toujours, à bin/jumphp run / test des projets).

Variables : JUMPHP_IDE_SERVER (un autre jumphp.net), JUMPHP_IDE_PROJECTS (où cloner, par défaut ~/JumPHP-Projects), JUMPHP_IDE_PROJECT (ouvrir ce dossier), JUMPHP_IDE_EVAL (JavaScript lancé dans la page : tests, captures).

Mises à jour : l'IDE installé se met à jour tout seul (games/ide/src/SelfUpdate.php). 8 s après son démarrage puis toutes les 6 heures, il lit games/ide/installer/update.json sur main, vérifie sa signature, télécharge la version plus récente, vérifie son SHA-256 et remplace son exécutable en arrière-plan ; une notification propose alors Restart Now (sinon le prochain démarrage la lance). Aide > Check for Updates…, Aide > Update Automatically (activé par défaut). Publier une version : augmenter version dans project.yaml, puis games/ide/tools/release.sh "Les nouveautés." (export Linux, Windows, macOS, update.json signé avec ~/.jumphp/keys/ide-update.pem — gardez une copie de cette clé —, release GitHub ide-v<version>, puis update.json et version.json poussés sur main). Les IDE plus anciens que la 0.1.3 n'ont pas cette mise à jour : à réinstaller une fois.

Le fonctionnement détaillé (cœur, index PHP, connexion par boucle locale, version web sur les brouillons) : ide.md.

Mises à jour du code (sans nouvel exécutable)

L'IDE de bureau est un exécutable (PHP + le runtime Tauri) qui porte son propre code. Une mise à jour du code ne remplace que le code : l'IDE télécharge une petite archive signée (environ 0,5 Mo : games/ide/src, config, et src et ui du paquet de l'IDE, sans Monaco) et tourne dessus au démarrage suivant. Une minute (games/ide/tools/release-code.sh "notes" après avoir monté version dans games/ide/config/game.yaml), contre un quart d'heure pour les trois exécutables (games/ide/tools/release.sh, toujours nécessaire quand l'exécutable change). Le mécanisme : JumPHP\Tauri\Overlay (moteur), games/ide/src/CodeUpdate.php côté IDE ; l'archive et l'update.json signé sont faits par tools/overlay-build.php.

Les précautions :

  • l'archive est annoncée par l'update.json signé (overlay : version, compat, adresse https, SHA-256) et n'est installée que si le téléchargement correspond à ce SHA-256, puis si chaque fichier correspond au SHA-256 du manifeste ;
  • une mise à jour n'écrit que dans src/, config/, vendor/jumphp/ide/src/ et vendor/jumphp/ide/ui/ : jamais le moteur, l'exécutable ni l'autoloader de Composer ; un chemin avec .., absolu, ou ailleurs est refusé. config/update.pub (la clé qui vérifie les mises à jour) n'y est jamais ;
  • overlay_compat dans game.yaml : le numéro de génération de l'exécutable. Une mise à jour faite pour un autre numéro est ignorée. Montez-le quand une version change ce qu'elle ne peut pas porter (le code du moteur, une extension PHP, le runtime, une dépendance de games/ide/composer.json) et publiez une version complète ;
  • retour arrière tout seul : dès qu'une mise à jour démarre, elle est en attente jusqu'à ce que la page de l'IDE soit chargée et ait demandé son état (session.state). Si le démarrage suivant la trouve en attente après une erreur fatale de PHP (erreur de syntaxe, exception non rattrapée : notée par une fonction d'arrêt), elle est marquée mauvaise, plus jamais essayée, et l'IDE tourne avec les fichiers de son exécutable. Un démarrage seulement non confirmé (une fenêtre figée que l'utilisateur ferme de force : cela arrive aussi sans mise à jour) a une autre chance, et la mise à jour n'est écartée qu'après 3 démarrages de suite (Overlay::MAX_TRIES) ;
  • les fichiers de l'exécutable ne sont jamais modifiés : la mise à jour tourne sur une copie faite de liens physiques, les anciennes copies sont supprimées ;
  • JUMPHP_NO_OVERLAY=1 démarre l'IDE avec les fichiers de son exécutable (sans toucher à la mise à jour), pour écarter un doute ;
  • les installeurs installent la dernière version complète (version.json n'est pas touché) ; l'IDE installé prend ensuite la mise à jour du code à sa première vérification.

Vue dans l'IDE comme une mise à jour normale : « disponible », « installation », « Redémarrer ». La version affichée est celle de la mise à jour. Les exécutables antérieurs à la 0.1.77 ne connaissent pas ces mises à jour : la version complète les met à jour, puis ils prennent les suivantes.