Symfony Form

https://github.com/symfony/form
Admin
The Symfony Form component simplifies the creation, processing, and reuse of HTML forms.
Tokens:284,916
Snippets:1,896
Trust Score:9.5
License:MIT
Update:3 days ago
Show doc for...
Tokens:
Raw
### Typical framework wiring with FormRenderer

Source: https://github.com/symfony/form

Shows how to instantiate FormRenderer with a Twig engine and CSRF token manager, create a view, set a custom theme, render blocks, get a CSRF token, and humanize a name. The example includes comments for each step.

```php
use Symfony\Component\Form\FormRenderer;
use Symfony\Component\Security\Csrf\CsrfTokenManager;

/** @var FormRendererEngineInterface $twigEngine */
$renderer = new FormRenderer($twigEngine, new CsrfTokenManager());

$view = $form->createView();

// Assign a custom theme to one view subtree:
$renderer->setTheme($view, '@App/form_theme.html.twig');

// Low-level calls in a template helper:
$html  = $renderer->searchAndRenderBlock($view['title'], 'widget');
$html .= $renderer->searchAndRenderBlock($view['title'], 'label');

// Bare CSRF token, outside a form:
$token = $renderer->renderCsrfToken('delete_post_'.$postId);

// make a name human readable:
echo $renderer->humanize('created_at'); // "Created at"
```

--------------------------------

### Usage example for FormConfigBuilder

Source: https://github.com/symfony/form

Shows how to create a form config builder, set options, and retrieve the frozen config. Outputs method, data_class option, and attribute check.

```php
use Symfony\Component\EventDispatcher\EventDispatcher;
use Symfony\Component\Form\FormConfigBuilder;
use Symfony\Component\Form\Forms;
use Symfony\Component\PropertyAccess\PropertyPath;

$factory = Forms::createFormFactory();

$builder = new FormConfigBuilder('user', User::class, new EventDispatcher(), ['data_class' => User::class]);
$builder->setFormFactory($factory);
$builder->setCompound(true)
    ->setPropertyPath(new PropertyPath('user'))
    ->setByReference(false)
    ->setMethod('PUT')          // stored as 'PUT'
    ->setAutoInitialize(true)
    ->setAction('/account/update')
    ->setData($user);

$config = $builder->getFormConfig(); // FormConfigInterface, frozen clone

echo $config->getMethod();               // PUT
echo $config->getOption('data_class');   // User
var_dump($config->hasAttribute('x'));    // false
```

--------------------------------

### Usage example for FormView

Source: https://github.com/symfony/form

Shows how to access child views, iterate over children, count fields, and handle attempts to assign children which throw BadMethodCallException.

```php
$view = $form->createView();           // root view

// Access children
$titleView = $view['title'];           // FormView via ArrayAccess
foreach ($view->children as $name => $childView) { /* ... */ }
echo count($view);                     // number of fields

// Template-side reads (Twig/PHP templating):
// {{ form_start(form) }} {{ form_widget(form.title) }} etc.
// $view->vars['id'], $view->vars['full_name'], $view->vars['errors'], ...

// Reject attempts to assign children:
try {
    $view['x'] = $view;
} catch (\Symfony\Component\Form\Exception\BadMethodCallException $e) {
    // 'Not supported.'
}
```

--------------------------------

### FormBuilder usage example

Source: https://github.com/symfony/form

Shows how to create a form builder, add fields, configure attributes, nest builders, and retrieve child builders. Demonstrates inherited configuration from FormConfigBuilderInterface and the getForm() method.

```php
use Symfony\Component\Form\Forms;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Extension\Core\Type\EmailType;

$factory = Forms::createFormFactory();

$builder = $factory->createBuilder(null, ['data_class' => User::class]);

$builder->add('firstName', TextType::class, ['attr' => ['maxlength' => 40]]);
$builder->add('email', EmailType::class);

// configuration inherited from FormConfigBuilderInterface:
$builder->setRequired(true)
    ->setAttribute('foo', 'bar')
    ->addEventListener(\Symfony\Component\Form\FormEvents::POST_SUBMIT, function ($event) {
        // ...
    });

// nesting builders:
$address = $builder->create('address', null, ['data_class' => Address::class])
    ->add('street', TextType::class)
    ->add('city', TextType::class);
$builder->add($address);

$form = $builder->getForm(); // FormInterface, auto-initialized

// child builders:
$streetBuilder = $builder->get('address')->get('street');
$builder->remove('email');
```

--------------------------------

### get

Source: https://github.com/symfony/form

Returns a child form by name.

```APIDOC
## get

### Description
Returns a child form by name.

### Method
get

### Signature
`public function get(string $name): self`

### Parameters
- `$name` (string) - Required - The name of the child form.

### Return Value
- `self` - The child form.
```

--------------------------------

### FormRegistry usage example

Source: https://github.com/symfony/form

Shows how to instantiate FormRegistry with a CoreExtension and a ResolvedFormTypeFactory, then retrieve a resolved type, inspect its block prefix and parent, check type existence, and handle a missing type exception.

```php
use Symfony\Component\Form\FormRegistry;
use Symfony\Component\Form\ResolvedFormTypeFactory;
use Symfony\Component\Form\Extension\Core\CoreExtension;

$registry = new FormRegistry([new CoreExtension()], new ResolvedFormTypeFactory());

$resolved = $registry->getType(\Symfony\Component\Form\Extension\Core\Type\EmailType::class);

echo $resolved->getBlockPrefix();              // 'email'
echo $resolved->getParent()->getBlockPrefix(); // 'text'  (EmailType's parent)
var_dump($registry->hasType('No\Such\Type'));  // false

try {
    $registry->getType('No\Such\Type');
} catch (\Symfony\Component\Form\Exception\InvalidArgumentException $e) {
    // 'Could not load type "No\Such\Type": class does not exist.'
}
```

--------------------------------

### Custom data mapper example

Source: https://github.com/symfony/form

Example of implementing a custom DataMapperInterface to transform data in a compound form.

```APIDOC
## Custom data mapper example

### Description
Example of implementing a custom DataMapperInterface to transform data in a compound form.

### Example

```php
use Symfony\Component\Form\DataMapperInterface;
use Symfony\Component\Form\FormInterface;

class UpperCaseDataMapper implements DataMapperInterface
{
    public function mapDataToForms(mixed $viewData, \Traversable $forms): void
    {
        foreach ($forms as $form) {
            $form->setData(strtoupper((string) $viewData));
        }
    }

    public function mapFormsToData(\Traversable $forms, mixed &$viewData): void
    {
        foreach ($forms as $form) {
            $viewData = $form->getData();
        }
    }
}

$builder = $formFactory->createBuilder(null, ['compound' => true])
    ->setDataMapper(new UpperCaseDataMapper())
    ->add('field', \Symfony\Component\Form\Extension\Core\Type\TextType::class);
```
```

--------------------------------

### Example: Manual guesser

Source: https://github.com/symfony/form

Shows how to implement a custom form type guesser and register it with the form factory.

```APIDOC
## Example: Manual guesser

```php
use Symfony\Component\Form\Guess\TypeGuess;
use Symfony\Component\Form\Guess\Guess;

class UuidGuesser implements \Symfony\Component\Form\FormTypeGuesserInterface
{
    public function guessType(string $class, string $property): ?TypeGuess
    {
        return str_ends_with($property, 'Uuid')
            ? new TypeGuess(\Symfony\Component\Form\Extension\Core\Type\TextType::class, [], Guess::MEDIUM_CONFIDENCE)
            : null;
    }

    public function guessRequired(string $class, string $property): ?\Symfony\Component\Form\Guess\ValueGuess { return null; }
    public function guessMaxLength(string $class, string $property): ?\Symfony\Component\Form\Guess\ValueGuess { return null; }
    public function guessPattern(string $class, string $property): ?\Symfony\Component\Form\Guess\ValueGuess { return null; }
}

$factory = Forms::createFormFactoryBuilder()
    ->addTypeGuesser(new UuidGuesser())
    ->getFormFactory();
```
```

--------------------------------

### HttpFoundationRequestHandler usage example

Source: https://github.com/symfony/form

Shows how to create a form factory with HttpFoundationExtension and handle a request.

```php
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Form\Forms;

$factory = Forms::createFormFactoryBuilder()
    ->addExtension(new \Symfony\Component\Form\Extension\HttpFoundation\HttpFoundationExtension())
    ->getFormFactory();

$form = $factory->createBuilder('search')
    ->add('q', \Symfony\Component\Form\Extension\Core\Type\TextType::class)
    ->getForm();

/** @var Request $request */
$form->handleRequest($request);    // submits only when the form is present in the request
```

--------------------------------

### Example output shape (text) for debug:form

Source: https://github.com/symfony/form

Illustrates the text output format for a form type, showing the parent chain and options list. Actual output may vary.

```text
Symfony\Component\Form\Extension\Core\Type\ChoiceType
=====================================================

Parent
------
Symfony\Component\Form\Extension\Core\Type\FormType

Options
-------
multiple, expanded, choices, choice_loader, ...
```

--------------------------------

### Example of guessing in action

Source: https://github.com/symfony/form

Shows how to create a form factory with ValidatorExtension and use it to create forms or builders for a property, leveraging type guessing.

```php
use Symfony\Component\Form\Forms;
use Symfony\Component\Form\Extension\Validator\ValidatorExtension;
use Symfony\Component\Validator\Validation;

$factory = Forms::createFormFactoryBuilder()
    ->addExtension(new ValidatorExtension(Validation::createValidator()))
    ->getFormFactory();

// 'email' property with an @Email constraint + nullable typing:
$form = $factory->createForProperty(\App\Entity\Contact::class, 'email');

// Same for builders:
$builder = $factory->createBuilderForProperty(\App\Entity\Contact::class, 'email');
```

--------------------------------

### get

Source: https://github.com/symfony/form

Returns the named child form. Throws an exception if the child does not exist.

```APIDOC
## get

### Description
Returns the named child.

### Method
get

### Parameters
- `$name` (string) - Required - The name of the child

### Throws
- `OutOfBoundsException` if it does not exist

### Returns
- `self`
```

--------------------------------

### StringUtil usage example

Source: https://github.com/symfony/form

Shows how to use StringUtil::fqcnToBlockPrefix and StringUtil::trim. fqcnToBlockPrefix converts a fully qualified class name to an underscored short name without the 'Type' suffix; trim removes whitespace and control characters.

```php
use Symfony\Component\Form\Util\StringUtil;

StringUtil::fqcnToBlockPrefix(\Symfony\Component\Form\Extension\Core\Type\TextType::class); // 'text'
StringUtil::trim("  foo\n");                                                               // 'foo'
```

--------------------------------

### Example: Guessing in action

Source: https://github.com/symfony/form

Demonstrates how to use the form factory to create forms with automatic type guessing, including using the Validator extension.

```APIDOC
## Example: Guessing in action

```php
use Symfony\Component\Form\Forms;
use Symfony\Component\Form\Extension\Validator\ValidatorExtension;
use Symfony\Component\Validator\Validation;

$factory = Forms::createFormFactoryBuilder()
    ->addExtension(new ValidatorExtension(Validation::createValidator()))
    ->getFormFactory();

// 'email' property with an @Email constraint + nullable typing:
$form = $factory->createForProperty(\App\Entity\Contact::class, 'email');

// Same for builders:
$builder = $factory->createBuilderForProperty(\App\Entity\Contact::class, 'email');
```
```

--------------------------------

### setData

Source: https://github.com/symfony/form

Sets the initial model data for the form. This data is used as the starting point for the form.

```APIDOC
## setData

### Description
Sets the initial model data for the form. This data is used as the starting point for the form.

### Method
`setData(mixed $data): static`

### Parameters
- `$data` (mixed) - Required - The initial model data.

### Return Value
Returns the builder instance for method chaining (fluent interface).
```

--------------------------------

### Forms::createFormFactoryBuilder() usage

Source: https://github.com/symfony/form

Creates a form factory builder with forceCoreExtension = true and adds a ValidatorExtension before getting the factory.

```php
use Symfony\Component\Form\Forms;
use Symfony\Component\Form\Extension\Validator\ValidatorExtension;
use Symfony\Component\Validator\Validation;

$factory = Forms::createFormFactoryBuilder()
    ->addExtension(new ValidatorExtension(Validation::createValidator()))
    ->getFormFactory();
```

--------------------------------

### FormUtil usage example

Source: https://github.com/symfony/form

Shows how to use FormUtil::isEmpty with various values. Returns true for null, empty string, and empty array; false for '0'.

```php
use Symfony\Component\Form\Util\FormUtil;

FormUtil::isEmpty(null);   // true
FormUtil::isEmpty('0');    // false
FormUtil::isEmpty('');     // true
```

--------------------------------

### debug:form command usage examples

Source: https://github.com/symfony/form

Shows typical invocations of the debug:form command. Without arguments lists all types; with a class shows type details; with an option shows option definition; --show-deprecated filters deprecated options; --format=json changes output format.

```console
$ bin/console debug:form
$ bin/console debug:form ChoiceType
$ bin/console debug:form ChoiceType choice_value
$ bin/console debug:form --show-deprecated
$ bin/console debug:form --format=json
```

--------------------------------

### Error handling during build

Source: https://github.com/symfony/form

Shows how to catch BadMethodCallException when calling mutating methods after the builder is frozen, and InvalidArgumentException when getting a non-existent child.

```php
use Symfony\Component\Form\Exception\BadMethodCallException;
use Symfony\Component\Form\Exception\InvalidArgumentException;

$form = $builder->getForm();

try {
    $builder->add('late', TextType::class); // already frozen
} catch (BadMethodCallException $e) {
    // "FormBuilder methods cannot be accessed anymore once the builder is turned into a FormConfigInterface instance."
}

try {
    $builder->get('missing');
} catch (InvalidArgumentException $e) {
    // 'The child with the name "missing" does not exist.'
}
```

--------------------------------

### Custom data mapper example

Source: https://github.com/symfony/form

Implements a custom DataMapperInterface that uppercases view data for all children. The mapper is set on a compound form builder; note that a compound form without a data mapper throws LogicException.

```php
use Symfony\Component\Form\DataMapperInterface;
use Symfony\Component\Form\FormInterface;

class UpperCaseDataMapper implements DataMapperInterface
{
    public function mapDataToForms(mixed $viewData, \Traversable $forms): void
    {
        foreach ($forms as $form) {
            $form->setData(strtoupper((string) $viewData));
        }
    }

    public function mapFormsToData(\Traversable $forms, mixed &$viewData): void
    {
        foreach ($forms as $form) {
            $viewData = $form->getData();
        }
    }
}

$builder = $formFactory->createBuilder(null, ['compound' => true])
    ->setDataMapper(new UpperCaseDataMapper())
    ->add('field', \Symfony\Component\Form\Extension\Core\Type\TextType::class);
```

--------------------------------

### Combining extensions

Source: https://github.com/symfony/form

Shows how to combine multiple form extensions when building a form factory. The example includes HttpFoundation, Csrf, Validator, and PasswordHasher extensions.

```APIDOC
## Combining extensions

### Description
Example of combining multiple form extensions when creating a form factory.

### Example
```php
use Symfony\Component\Form\Forms;
use Symfony\Component\Form\Extension\HttpFoundation\HttpFoundationExtension;
use Symfony\Component\Form\Extension\Csrf\CsrfExtension;
use Symfony\Component\Form\Extension\Validator\ValidatorExtension;
use Symfony\Component\Form\Extension\PasswordHasher\PasswordHasherExtension;
use Symfony\Component\Form\Extension\PasswordHasher\EventListener\PasswordHasherListener;
use Symfony\Component\Security\Csrf\CsrfTokenManager;
use Symfony\Component\Validator\Validation;
use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasher;

$factory = Forms::createFormFactoryBuilder()
    ->addExtension(new HttpFoundationExtension())
    ->addExtension(new CsrfExtension(new CsrfTokenManager()))
    ->addExtension(new ValidatorExtension(Validation::createValidator()))
    ->addExtension(new PasswordHasherExtension(new PasswordHasherListener($hasher)))
    ->getFormFactory();
```

> Note: `PasswordHasherListener` requires `symfony/password-hasher`; the `HtmlSanitizerExtension` requires `symfony/html-sanitizer`; neither is a hard dependency of `symfony/form` (`require-dev` only).
```

--------------------------------

### ServerParams usage example

Source: https://github.com/symfony/form

Shows how to use ServerParams to check if the POST max size has been exceeded. If exceeded, display a 'too large' message instead of submitting.

```php
use Symfony\Component\Form\Util\ServerParams;

$params = new ServerParams();
if ($params->hasPostMaxSizeBeenExceeded()) {
    // show "too large" message instead of submitting
}
```

--------------------------------

### Registering listeners

Source: https://github.com/symfony/form

Demonstrates how to attach event listeners to a form builder using the addEventListener method. This example shows normalization of request data on pre-submit and handling post-submit events.

```APIDOC
## Registering listeners

### Description
Listeners are attached to the builder (or via a type's `buildForm()`).

### Example
```php
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\FormEvents;
use Symfony\Component\Form\Event\PreSubmitEvent;
use Symfony\Component\Form\Event\PostSubmitEvent;

$builder = $formFactory->createBuilder()
    ->add('code', TextType::class);

$builder->addEventListener(FormEvents::PRE_SUBMIT, function (PreSubmitEvent $event): void {
    $data = $event->getData();
    if (\is_string($data)) {
        $event->setData(strtoupper(trim($data))); // normalize request data
    }
}, 10 /* priority: higher runs first */);

$builder->addEventListener(FormEvents::POST_SUBMIT, function (PostSubmitEvent $event): void {
    $form = $event->getForm();
    if ($form->isValid()) {
        // $event->getData() holds the view data
        // $form->getData() holds the model data
    }
});

$form = $builder->getForm();
```
```

--------------------------------

### Usage: plain class with AsFormType and FormField attributes

Source: https://github.com/symfony/form

Application code example showing how to define a form type from a plain class using the attributes. The class name can then be used as a form type in the full-stack framework.

```php
use Symfony\Component\Form\Attribute\AsFormType;
use Symfony\Component\Form\Attribute\FormField;
use Symfony\Component\Form\Extension\Core\Type\EmailType;
use Symfony\Component\Form\Extension\Core\Type\TextType;

#[AsFormType(options: ['attr' => ['class' => 'contact']])]
class ContactFormData
{
    #[FormField(type: TextType::class, options: ['label' => 'Name'])]
    public string $name = '';

    #[FormField(type: EmailType::class)]
    public string $email = '';

    #[FormField(name: 'bio', type: TextType::class)]
    public string $about = '';
}
```

```php
$form = $formFactory->createNamedBuilder('contact', ContactFormData::class, $data, [])
    ->getForm();
```

--------------------------------

### initialize

Source: https://github.com/symfony/form

Initializes this form.

```APIDOC
## initialize

### Description
Initializes this form.

### Method
initialize

### Signature
`public function initialize(): static`

### Parameters
None.

### Return Value
- `static` - The current form instance.
```

--------------------------------

### Form::initialize

Source: https://github.com/symfony/form

Initializes the form.

```APIDOC
## Form::initialize

### Description
Initializes the form.

### Method
Initialization

### Signature
```php
public function initialize(): static;
```

### Return Value
- **static** - The current form instance.
```

--------------------------------

### setParent / getParent

Source: https://github.com/symfony/form

Sets or gets the parent form. Throws exceptions for submitted forms or when a form with an empty name gets a parent.

```APIDOC
## setParent / getParent

### Description
Sets or gets the parent form. Throws exceptions for submitted forms or when a form with an empty name gets a parent.

### Method
N/A (PHP method)

### Endpoint
N/A

### Parameters
#### Method Parameters
- `?FormInterface $parent` (FormInterface|null) - Required - The parent form to set.

### Response
#### Return Value
- `static` for setParent; `?FormInterface` for getParent.

### Exceptions
- `AlreadySubmittedException` - If the form is already submitted.
- `LogicException` - When a form with an empty name gets a parent.
```

--------------------------------

### ReversedTransformer usage example

Source: https://github.com/symfony/form

Swaps the direction of a transformer: transform() calls the inner reverseTransform() and vice versa. The example creates a transformer that uppercases on transform and lowercases on reverse, then reverses it to output 'abc'.

```php
use Symfony\Component\Form\ReversedTransformer;
use Symfony\Component\Form\CallbackTransformer;

$upper = new CallbackTransformer(
    static fn (mixed $v): mixed => strtoupper((string) $v),
    static fn (mixed $v): mixed => strtolower((string) $v),
);
$reversed = new ReversedTransformer($upper);

echo $reversed->transform('AbC'); // 'abc'
```

--------------------------------

### Building a form factory with FormFactoryBuilder

Source: https://github.com/symfony/form

Shows how to use FormFactoryBuilder to add a custom type and then build the form factory.

```php
use Symfony\Component\Form\Forms;
use Symfony\Component\Form\PreloadedExtension;

$builder = Forms::createFormFactoryBuilder();
$builder->addType(new \App\Form\PersonType());
$formFactory = $builder->getFormFactory();
```

--------------------------------

### create

Source: https://github.com/symfony/form

Returns a form; the name defaults to the type's block prefix. Throws InvalidOptionsException when any given option is not applicable to the given type.

```APIDOC
## create

### Description
Returns a form; the name defaults to the type's block prefix.

### Method
create

### Signature
`create(string $type = FormType::class, mixed $data = null, array $options = []): FormInterface`

### Parameters
- `$type` (string) - Optional - The form type class name, defaults to `FormType::class`.
- `$data` (mixed) - Optional - Initial data for the form.
- `$options` (array) - Optional - Options for the form type.

### Return Value
`FormInterface` (or `FormFlowInterface` when `$type` is a `FormFlowTypeInterface` class-string)

### Exceptions
`Symfony\Component\OptionsResolver\Exception\InvalidOptionsException` when any given option is not applicable to the given type.
```

--------------------------------

### get

Source: https://github.com/symfony/form

Returns a child form by name. Throws OutOfBoundsException if the child does not exist.

```APIDOC
## get

### Description
Returns a child form by name. Throws OutOfBoundsException if the child does not exist.

### Method
N/A (PHP method)

### Endpoint
N/A

### Parameters
#### Method Parameters
- `string $name` (string) - Required - The name of the child form.

### Response
#### Return Value
- `FormInterface`

### Exceptions
- `OutOfBoundsException` - If the child does not exist.
```

--------------------------------

### Using FormFactory to create forms

Source: https://github.com/symfony/form

Shows how to create a form factory and use it to create a form for a single property with a guessed type, and to create a named builder with explicit data.

```php
use Symfony\Component\Form\Forms;

$factory = Forms::createFormFactory();

// Create a form for a single property with a guessed type:
$form = $factory->createForProperty(\App\Entity\Product::class, 'price');

// Named builder with explicit data:
$builder = $factory->createNamedBuilder('product', null, $product, [
    'data_class' => \App\Entity\Product::class,
]);
```

--------------------------------

### get(string $name): self

Source: https://github.com/symfony/form

Returns a child builder by name. Throws an InvalidArgumentException if the child does not exist.

```APIDOC
## get(string $name): self

### Description
Returns a child builder by name. Throws an InvalidArgumentException if the child does not exist.

### Method
get

### Parameters
- **$name** (string) - Required - The name of the child builder.

### Return Value
- **self** - The child builder.

### Throws
- **BadMethodCallException** - If the builder is locked (after getFormConfig() or getForm() is called).
- **InvalidArgumentException** - If the child with the given name does not exist.
```

--------------------------------

### initialize

Source: https://github.com/symfony/form

Initializes the form tree. This method is intended for the root form only and throws an exception otherwise.

```APIDOC
## initialize

### Description
Initializes the tree; root only.

### Method
initialize

### Throws
- `RuntimeException`

### Returns
- `static`
```

--------------------------------

### FormIntegrationTestCase::getTwigEnvironment()

Source: https://github.com/symfony/form

Returns the Twig environment for rendering assertions. Available when symfony/twig-bridge is installed.

```APIDOC
## FormIntegrationTestCase::getTwigEnvironment()

### Description
Returns the Twig environment for rendering assertions. Available when symfony/twig-bridge is installed.

### Method
protected function getTwigEnvironment()

### Parameters
None

### Return Value
- **Twig\Environment** - The Twig environment instance
```

--------------------------------

### Create a form with various core types

Source: https://github.com/symfony/form

Builds a form factory and a form builder for a 'survey' form with a data class, adding fields of different core types: RangeType, ChoiceType, BirthdayType, MoneyType, TextareaType, RepeatedType with PasswordType, CollectionType with FileType, and SubmitType. Demonstrates typical options like multiple/expanded for choices, currency/scale for money, and allow_add/allow_delete for collections.

```php
use Symfony\Component\Form\Forms;
use Symfony\Component\Form\Extension\Core\Type as T;

$factory = Forms::createFormFactory();
$form = $factory->createBuilder('survey', null, ['data_class' => Survey::class])
    ->add('difficulty', T\RangeType::class)
    ->add('topics', T\ChoiceType::class, [
        'choices' => ['PHP' => 'php', 'JS' => 'js'],
        'multiple' => true,
        'expanded' => true,
    ])
    ->add('birthday', T\BirthdayType::class, ['widget' => 'single_text'])
    ->add('budget', T\MoneyType::class, ['currency' => 'USD', 'scale' => 2])
    ->add('intro', T\TextareaType::class)
    ->add('password', T\RepeatedType::class, [
        'type' => T\PasswordType::class,
        'first_options' => ['label' => 'Password'],
        'second_options' => ['label' => 'Repeat'],
    ])
    ->add('attachments', T\CollectionType::class, [
        'entry_type' => T\FileType::class,
        'allow_add' => true,
        'allow_delete' => true,
    ])
    ->add('save', T\SubmitType::class)
    ->getForm();
```

--------------------------------

### initialize(): static

Source: https://github.com/symfony/form

Initializes the form tree, guaranteeing *_SET_DATA events fire. Must be called on the root form.

```APIDOC
## initialize(): static

### Description
Initializes the form tree, guaranteeing `*_SET_DATA` events fire. Must be called on the root form (builders do this automatically when `auto_initialize` is true).

### Method
initialize

### Signature
`initialize(): static`

### Throws
- `RuntimeException` - when called on a non-root form.
```

--------------------------------

### all

Source: https://github.com/symfony/form

Returns all children keyed by name.

```APIDOC
## all

### Description
All children keyed by name.

### Method
all

### Returns
- `array`
```

--------------------------------

### Architecture diagram of Forms::createFormFactory()

Source: https://github.com/symfony/form

Shows the internal structure of the form factory creation, including FormFactoryBuilder, CoreExtension, PreloadedExtension, FormRegistry, and FormFactory. Useful for understanding how form types are resolved and builders are created.

```text
Forms::createFormFactory()
 └─ FormFactoryBuilder(true)          collects FormExtensionInterface, types, type extensions, guessers
     └─ getFormFactory()
         ├─ CoreExtension (prepended) + user extensions
         ├─ PreloadedExtension        wraps direct types/extensions/guessers (if any)
         ├─ FormRegistry              resolves type FQCNs → ResolvedFormType (parent chain, extensions, OptionsResolver)
         └─ FormFactory               creates named builders via the registry
             └─ ResolvedFormType::createBuilder() → FormBuilder / ButtonBuilder / SubmitButtonBuilder
                 └─ getForm() → Form / Button / SubmitButton
```

--------------------------------

### getConfig

Source: https://github.com/symfony/form

Returns the configuration of this form.

```APIDOC
## getConfig

### Description
Returns the configuration of this form.

### Method
getConfig

### Signature
`public function getConfig(): FormConfigInterface`

### Parameters
None.

### Return Value
- `FormConfigInterface` - The form configuration.
```

--------------------------------

### getRoot

Source: https://github.com/symfony/form

Returns the root form.

```APIDOC
## getRoot

### Description
Root accessor.

### Method
getRoot

### Returns
- `self`
```

--------------------------------

### createView

Source: https://github.com/symfony/form

Builds the form view.

```APIDOC
## createView

### Description
Builds the view.

### Method
createView

### Parameters
- `$parent` (?FormView) - Optional - The parent view

### Returns
- `FormView`
```

--------------------------------

### Form::__construct

Source: https://github.com/symfony/form

Creates a new Form instance with the given configuration.

```APIDOC
## Form::__construct

### Description
Creates a new Form instance with the given configuration.

### Method
Constructor

### Signature
```php
public function __construct(private FormConfigInterface $config);
```

### Parameters
- **$config** (FormConfigInterface) - Required - The form configuration.
```

--------------------------------

### CallbackTransformer usage example

Source: https://github.com/symfony/form

Wraps two closures to transform data between model and normalized formats. The transform closure rounds numeric values, and reverseTransform divides by 100. Outputs '150' and '1.5'.

```php
use Symfony\Component\Form\CallbackTransformer;

$transformer = new CallbackTransformer(
    transform: static fn (mixed $data): mixed => \is_numeric($data) ? round($data * 100) : $data,
    reverseTransform: static fn (mixed $data): mixed => $data / 100,
);

echo $transformer->transform('1.5');       // 150
echo $transformer->reverseTransform(150);  // 1.5
```

--------------------------------

### Bootstrap Symfony Form with Forms::createFormFactory()

Source: https://github.com/symfony/form

Creates a form factory and builds a form with firstName and age fields using TextType and IntegerType. Use this to quickly set up a form without custom configuration.

```php
use Symfony\Component\Form\Forms;

$formFactory = Forms::createFormFactory();

$form = $formFactory->createBuilder()
    ->add('firstName', \Symfony\Component\Form\Extension\Core\Type\TextType::class)
    ->add('age', \Symfony\Component\Form\Extension\Core\Type\IntegerType::class)
    ->getForm();
```

--------------------------------

### all(): array

Source: https://github.com/symfony/form

Returns all child builders keyed by name.

```APIDOC
## all(): array

### Description
Returns all child builders keyed by name.

### Method
all

### Parameters
None

### Return Value
- **array** - An associative array of child builders keyed by name.

### Throws
- **BadMethodCallException** - If the builder is locked (after getFormConfig() or getForm() is called).
```

--------------------------------

### FormBuilderInterface definition

Source: https://github.com/symfony/form

Defines the interface for form builders, extending Traversable, Countable, and FormConfigBuilderInterface. Methods add, create, get, remove, has, all, and getForm manage child builders and produce the final Form instance.

```php
/**
 * @extends \Traversable<string, FormBuilderInterface>
 */
interface FormBuilderInterface extends \Traversable, \Countable, FormConfigBuilderInterface
{
    public function add(string|self $child, ?string $type = null, array $options = []): static;
    public function create(string $name, ?string $type = null, array $options = []): self;
    public function get(string $name): self;
    public function remove(string $name): static;
    public function has(string $name): bool;
    public function all(): array;
    public function getForm(): FormInterface;
}
```

--------------------------------

### Form::getConfig

Source: https://github.com/symfony/form

Returns the form configuration.

```APIDOC
## Form::getConfig

### Description
Returns the form configuration.

### Method
Getter

### Signature
```php
public function getConfig(): FormConfigInterface;
```

### Return Value
- **FormConfigInterface** - The form configuration.
```

--------------------------------

### Catch double submission of a submit button

Source: https://github.com/symfony/form

Shows that submitting a submit button twice throws an AlreadySubmittedException with the message 'A form can only be submitted once.' The example catches the exception after the second submit call.

```php
use Symfony\Component\Form\Exception\AlreadySubmittedException;

$form = $factory->createNamedBuilder('f')
    ->add('go', SubmitType::class)
    ->getForm();

$form->get('go')->submit('go');
try {
    $form->get('go')->submit('go');   // double submission
} catch (AlreadySubmittedException $e) {
    // 'A form can only be submitted once.'
}
```

--------------------------------

### getEngine

Source: https://github.com/symfony/form

Returns the injected form renderer engine.

```APIDOC
## getEngine

### Description
Returns the injected form renderer engine.

### Method
`getEngine(): FormRendererEngineInterface`

### Response
#### Success Response
- **FormRendererEngineInterface** - The injected engine.
```

--------------------------------

### all

Source: https://github.com/symfony/form

Returns all child forms as an array.

```APIDOC
## all

### Description
Returns all child forms as an array.

### Method
all

### Signature
`public function all(): array`

### Parameters
None.

### Return Value
- `array` - An array of child forms.
```

--------------------------------

### FormRegistry constructor signature

Source: https://github.com/symfony/form

Constructor for the FormRegistry class. Throws UnexpectedTypeException if any extension does not implement FormExtensionInterface.

```php
public function __construct(
    array $extensions,                       // FormExtensionInterface[]
    private ResolvedFormTypeFactoryInterface $resolvedTypeFactory,
)
```

--------------------------------

### Forms::createFormFactory() usage

Source: https://github.com/symfony/form

Creates a form factory with default configuration and builds a form with text and choice fields.

```php
use Symfony\Component\Form\Forms;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Extension\Core\Type\ChoiceType;

$factory = Forms::createFormFactory();
$form = $factory->createBuilder()
    ->add('firstName', TextType::class)
    ->add('color', ChoiceType::class, ['choices' => ['Red' => 'r', 'Blue' => 'b']])
    ->getForm();
```

--------------------------------

### Constructor

Source: https://github.com/symfony/form

Builds a Form instance through a builder, not directly. Throws a LogicException if the form is compound and no data mapper is configured.

```APIDOC
## Constructor

### Description
Build a `Form` through a builder (`FormBuilder::getForm()`), not directly.

### Method
`__construct`

### Signature
```php
public function __construct(private FormConfigInterface $config)
```

### Parameters
- `$config` (FormConfigInterface) - Required - The form configuration.

### Throws
- `Symfony\Component\Form\Exception\LogicException` - "Compound forms need a data mapper." when `$config->getCompound()` is true and no data mapper is configured.
```

--------------------------------

### FormView::__construct

Source: https://github.com/symfony/form

Creates a new FormView instance with an optional parent view.

```APIDOC
## FormView::__construct

### Description
Creates a new FormView instance with an optional parent view.

### Method
Constructor

### Signature
`public function __construct(public ?self $parent = null)`

### Parameters
- `$parent` (?FormView) - Optional - The parent view.
```

--------------------------------

### Form::all

Source: https://github.com/symfony/form

Returns all children of the form.

```APIDOC
## Form::all

### Description
Returns all children of the form.

### Method
Getter

### Signature
```php
public function all(): array;
```

### Return Value
- **array** - The children.
```

--------------------------------

### createView

Source: https://github.com/symfony/form

Creates a view for this form.

```APIDOC
## createView

### Description
Creates a view for this form.

### Method
createView

### Signature
`public function createView(?FormView $parent = null): FormView`

### Parameters
- `$parent` (?FormView) - Optional - The parent view.

### Return Value
- `FormView` - The created view.
```

--------------------------------

### Form::getRoot

Source: https://github.com/symfony/form

Returns the root form.

```APIDOC
## Form::getRoot

### Description
Returns the root form.

### Method
Getter

### Signature
```php
public function getRoot(): FormInterface;
```

### Return Value
- **FormInterface** - The root form.
```

--------------------------------

### getConfig

Source: https://github.com/symfony/form

Returns the immutable configuration of the form.

```APIDOC
## getConfig

### Description
Immutable configuration.

### Method
getConfig

### Returns
- `FormConfigInterface`
```

--------------------------------

### Using getter/setter options with TextType

Source: https://github.com/symfony/form

Shows how to configure getter/setter callbacks on a form field. The getter receives ($viewData, $form) and returns the value; the setter receives (&$viewData, $value, $form) and modifies $viewData in place.

```php
use Symfony\Component\Form\Extension\Core\Type\TextType;

$builder = $formFactory->createBuilder(null, ['data_class' => null])
    ->add('title', TextType::class, [
        'mapped' => false,                     // skip ordinary mapping
    ]);

// or with explicit getters/setters on a mapped field:
$builder->add('title', TextType::class, [
    'getter' => static fn (array $viewData, $form): string => $viewData['title'] ?? '',
    'setter' => static function (array &$viewData, mixed $value, $form): void {
        $viewData['title'] = strtoupper((string) $value);
    },
]);
```

--------------------------------

### Forms::createFormFactory()

Source: https://github.com/symfony/form

Returns a form factory with the default configuration, equivalent to calling createFormFactoryBuilder()->getFormFactory(). Use this static method to quickly obtain a configured form factory.

```APIDOC
## [STATIC] Forms::createFormFactory()

### Description
Returns a form factory with the default configuration (equivalent to `self::createFormFactoryBuilder()->getFormFactory()`).

### Method
Static method

### Endpoint
`Forms::createFormFactory()`

### Parameters
None

### Response
Returns a `FormFactoryInterface` instance.

### Request Example
```php
use Symfony\Component\Form\Forms;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Extension\Core\Type\ChoiceType;

$factory = Forms::createFormFactory();
$form = $factory->createBuilder()
    ->add('firstName', TextType::class)
    ->add('color', ChoiceType::class, ['choices' => ['Red' => 'r', 'Blue' => 'b']])
    ->getForm();
```
```

--------------------------------

### setAutoInitialize

Source: https://github.com/symfony/form

Sets whether the form should be initialized automatically when `getForm()` is called. Only applies to root forms.

```APIDOC
## setAutoInitialize

### Description
Sets whether the form should be initialized automatically when `getForm()` is called. Only applies to root forms.

### Method
`setAutoInitialize(bool $initialize): static`

### Parameters
- `$initialize` (bool) - Required - Whether to auto-initialize.

### Return Value
Returns the builder instance for method chaining (fluent interface).
```

--------------------------------

### OptionsResolverWrapper::getInfo

Source: https://github.com/symfony/form

Returns the info message for an option, or null if not set.

```APIDOC
## OptionsResolverWrapper::getInfo

### Description
Returns the info message for an option, or null if not set.

### Method
`public function getInfo(string $option): ?string`

### Parameters
- `$option` (string) - Required - The option name.

### Return Value
- (?string) - The info message, or null if not set.
```

--------------------------------

### submit

Source: https://github.com/symfony/form

Submits data to the form. Throws an exception if the form is already submitted.

```APIDOC
## submit

### Description
Submits data.

### Method
submit

### Parameters
- `$submittedData` (string|array|null) - Required - The data to submit
- `$clearMissing` (bool) - Optional - Whether to clear missing fields

### Throws
- `AlreadySubmittedException`

### Returns
- `static`
```

--------------------------------

### createBuilder

Source: https://github.com/symfony/form

Returns a form builder. Throws InvalidOptionsException when any given option is not applicable to the given type.

```APIDOC
## createBuilder

### Description
Returns a form builder.

### Method
createBuilder

### Signature
`createBuilder(string $type = FormType::class, mixed $data = null, array $options = []): FormBuilderInterface`

### Parameters
- `$type` (string) - Optional - The form type class name, defaults to `FormType::class`.
- `$data` (mixed) - Optional - Initial data for the form.
- `$options` (array) - Optional - Options for the form type.

### Return Value
`FormBuilderInterface` (or `FormFlowBuilderInterface`)

### Exceptions
`Symfony\Component\OptionsResolver\Exception\InvalidOptionsException` when any given option is not applicable to the given type.
```

--------------------------------

### FormFlowConfigInterface::getInitialOptions

Source: https://github.com/symfony/form

Returns the initial options for the form flow.

```APIDOC
## getInitialOptions(): array

### Description
Returns the initial options for the form flow.

### Return Value
- **array** - An array of initial options.
```

--------------------------------

### StringUtil::fqcnToBlockPrefix

Source: https://github.com/symfony/form

Converts a fully qualified class name to a block prefix by underscoring the short class name and removing the 'Type' suffix. Returns null for non-type names.

```APIDOC
## StringUtil::fqcnToBlockPrefix

### Description
Converts a fully qualified class name to a block prefix by underscoring the short class name and removing the 'Type' suffix. Returns null for non-type names.

### Method
`public static function fqcnToBlockPrefix(string $fqcn): ?string`

### Parameters
- `$fqcn` (string) - Required - The fully qualified class name.

### Return Value
- (?string) - The block prefix, or null if the class name does not end with 'Type'.

### Example
```php
StringUtil::fqcnToBlockPrefix('App\Form\UserProfileType'); // 'user_profile'
```
```

--------------------------------

### getParent

Source: https://github.com/symfony/form

Returns the parent form, or null if this is the root form.

```APIDOC
## getParent

### Description
Returns the parent.

### Method
getParent

### Returns
- `?self`
```

--------------------------------

### add

Source: https://github.com/symfony/form

Adds or replaces a child form, either by instance or by name, type, and options. Throws exceptions if the form is already submitted, if the form is not compound, or if the child type is unexpected.

```APIDOC
## add

### Description
Adds/replaces a child (by instance or name+type+options).

### Method
add

### Parameters
- `$child` (self|string) - Required - The child form instance or name
- `$type` (?string) - Optional - The form type
- `$options` (array) - Optional - The options for the form type

### Throws
- `AlreadySubmittedException`
- `LogicException` (non-compound)
- `UnexpectedTypeException`

### Returns
- `static`
```

--------------------------------

### getExtensions(): array

Source: https://github.com/symfony/form

Returns the list of form extensions registered with the registry.

```APIDOC
## getExtensions(): array

### Description
Returns the list of form extensions registered with the registry.

### Method
`getExtensions`

### Parameters
None

### Return Value
- **array** - The list of form extensions.
```

--------------------------------

### Form::get

Source: https://github.com/symfony/form

Returns a child form by name.

```APIDOC
## Form::get

### Description
Returns a child form by name.

### Method
Getter

### Signature
```php
public function get(string $name): FormInterface;
```

### Parameters
- **$name** (string) - Required - The name of the child.

### Return Value
- **FormInterface** - The child form.
```

--------------------------------

### getFormConfig(): FormConfigInterface

Source: https://github.com/symfony/form

Returns a clone of the builder's configuration. The clone is locked, and the children lists are stripped.

```APIDOC
## getFormConfig(): FormConfigInterface

### Description
Returns a clone of the builder's configuration. The clone is locked, and the children lists are stripped.

### Method
getFormConfig

### Parameters
None

### Return Value
- **FormConfigInterface** - The configuration clone.

### Throws
- **BadMethodCallException** - If the builder is locked (after getFormConfig() or getForm() is called).
```

--------------------------------

### Creating a form view with createView()

Source: https://github.com/symfony/form

Builds the view tree by calling the type's createView(), buildView(), creating child views recursively, sorting by priority, and calling finishView(). The resulting view can be rendered in templates using form() and form_row().

```php
$view = $form->createView();
// render in a template: form($view), form_row($view['title']), ...
```
Tokens:
Raw