- 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
4 KiB
Symfony forms
The Symfony Forms window (right tool bar, or Tools > Symfony Forms) lists the project's FormTypes (src/Form/*Type.php) and its
form themes. It appears in a project whose composer.json requires symfony/form (or that has src/Form/). Click a form type, or
use Open the Form Builder on This File on the FormType open in the editor, or New form type…: the form builder opens over
the workbench.
Fields
- + adds a field: Symfony's types grouped like its reference (text, numbers, choices, dates, other, buttons) and the project's own form types (sub-forms). Drag a field (or ↑ ↓) to reorder, the bin removes it.
- Add fields from the class… reads the form's data class (an entity or a DTO) and proposes its properties, each with the type it
suggests: from the Doctrine mapping (
text→ TextareaType,decimal→ MoneyType for a price, dates → DateType / DateTimeType,enumType→ EnumType, ManyToOne → EntityType, ManyToMany → EntityTypemultiple, OneToMany → CollectionType), from the PHP type (bool → CheckboxType, an enum → EnumType) and the name (email, password, url, phone, color). Nullable columns getrequired: false; the identifier and the timestamps come unchecked.
Options
The middle column edits the selected field: its name, its type, then the options of that type by kind: label (or none), required,
help, attr, row_attr, constraints (Symfony's validator constraints, each with its own options), choices, expanded,
multiple, placeholder, an EntityType's class and query_builder, a CollectionType's entry_type, entry_options, allow_add,
allow_delete, by_reference, prototype, a RepeatedType's type and first / second options, dates' widget, input, html5.
Other options are shown and edited as PHP code.
- Form (configureOptions):
data_class,validation_groups,csrf_protection,csrf_token_id,allow_extra_fields,translation_domain,attr. - Events:
FormEvents::PRE_SET_DATA,POST_SUBMIT… with their listener method, made in the class when it lacks it. - Data transformers: model or view transformers of a field; their class is made in
src/when it does not exist.
Preview
The right column shows the form as the chosen theme renders it, without running PHP: Symfony's default theme, the table theme,
Bootstrap 5 or Tailwind 2, inside the project's own page (base.html.twig and its stylesheets). Show errors shows the error
states, with the message of each field's first constraint. Theme chooses the project's themes (twig.yaml) or one for this form.
Save and generate
-
Save… shows a diff, then writes the FormType: only what changed is written where it is (one option, a line added or removed, the fields moved); comments and the rest of the file are kept as they were. What the builder cannot edit (an
add()inside anif, a closure listener, aCallbackTransformer) is shown locked and never changed.
-
Generate controller and template… makes the action that shows and handles the form (
createForm,handleRequest, valid:persist/flushfor an entity, or the DTO used, a flash message, a redirection), in an existing controller or a new one, and its Twig template (form_start, aform_row()per field orform_widget(form),form_end), shown as diffs. -
Change the themes… sets
form_themesinconfig/packages/twig.yaml.
Limits
- A field moved to another
$builderstatement stays in its own statement (the order is kept inside each add() chain). - Removing an event or a transformer leaves its method or class in place.
- The preview knows Symfony's themes, not a project's own theme blocks; EntityType choices and enum labels are samples.


