New in Symfony 5.3: Form Handler Helper

Contributed by Kévin Dunglas in #40799.

The recommended way of processing Symfony forms is to use a single action for both rendering the form and handling the form submit. This is how it looks in practice: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21// src/Controller/ConferenceController.php // ...

[Route('/{id}/edit', name: 'conference_edit', methods: ['GET', 'POST'])]

public function edit(Request $request, Conference $conference): Response { $form = $this->createForm(ConferenceType::class, $conference);

$form->handleRequest($request);
if ($form->isSubmitted() && $form->isValid()) {
    // do something with the $conference object
    // (e.g. persist it in the database)

    return $this->redirectToRoute('conference_show', [
        'id' => $conference->getId(),
    ]);
}

return $this->render('conference/edit.html.twig', [
    'form' => $form->createView(),
]);

}

When using libraries such as Symfony UX Turbo this simple form handling is not enough and you have to follow the HTTP protocol strictly (e.g. if the form is submitted but invalid, the response must have a HTTP 422 status code). In order to simplify the form handling in those cases, Symfony 5.3 adds a new (optional) helper to handle forms. This helper is defined in the AbstractController base controller as a new method called handleForm(). This is how the previous example looks when using the new helper: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25// src/Controller/ConferenceController.php // ...

[Route('/{id}/edit', name: 'conference_edit', methods: ['GET', 'POST'])]

public function edit(Request $request, Conference $conference): Response { return $this->handleForm( $this->createForm(ConferenceType::class, $conference), $request, function (FormInterface $form) use ($conference) { // do something with the $conference object // (e.g. persist it in the database)

        return $this->redirectToRoute(
            'conference_show',
            ['id' => $conference->getId()],
            Response::HTTP_SEE_OTHER
        );
    },
    function (FormInterface $form) {
        return $this->render('conference/edit.html.twig', [
            'form' => $form->createView(),
        ]);
    }
);

}

The signature of the handleForm() method is: 1handleForm(FormInterface $form, Request $request, callable $onSuccess, callable $render): Response

Both $onSuccess and $render callables must return a Response object. This is how it works in practice:

if the form is not submitted, the $render callable is called; if the form is submitted but invalid, the $render callable is called and a 422 HTTP status code is set if the current status hasn’t been customized; if the form is submitted and valid, the $onSuccess callable is called (which is usually where you persist the data and return the 303 HTTP redirection).

                Sponsor the Symfony project.

http://feedproxy.google.com/~r/symfony/blog/~3/tgna0PcoiTE/new-in-symfony-5-3-form-handler-helper

Creado 4y | 30 abr 2021, 7:20:07


Inicia sesión para agregar comentarios

Otros mensajes en este grupo.

A Week of Symfony #966 (June 30 – July 6, 2025)

This week, development on the upcoming Symfony 8.0 version continued with the removal of deprecated features and the marking of several classes as final. In addition, we published two new case studies

6 jul 2025, 8:10:15 | Symfony
Case study: Modernizing Audi France’s Digital Ecosystem with Symfony 6

At Wide, Micropole’s digital agency, they help leading brands modernize their digital infrastructures while ensuring scalability, security, and performance. When Audi France approached them to migrate

4 jul 2025, 9:40:14 | Symfony
Case study: A Long-Term Powerhouse Behind Vente-unique.com's E-Commerce Success (Zero Churn, All Wins!)

Vente-unique.com, a leading European online retailer of furniture and home decor, operates in 11 countries, powered by a team of 400 professionals and serving more than 3 million customers. From 15 ye

2 jul 2025, 9:10:03 | Symfony
A Week of Symfony #965 (June 23–29, 2025)

This week, Symfony 6.4.23, 7.2.8 and 7.3.1 maintenance versions were released. Meanwhile, the upcoming Symfony 7.4 version continued adding new features such as better controller helpers, more precisi

29 jun 2025, 9:10:15 | Symfony
Symfony 6.4.23 released

Symfony 6.4.23 has just been released. Read the Symfony upgrade guide to learn more about upgrading Symfony and use the SymfonyInsight upgrade reports to detect the code you will need to change in you

28 jun 2025, 9:50:15 | Symfony
Symfony 7.2.8 released

Symfony 7.2.8 has just been released. Read the Symfony upgrade guide to learn more about upgrading Symfony and use the SymfonyInsight upgrade reports to detect the code you will need to change in your

28 jun 2025, 9:50:15 | Symfony
Symfony 7.3.1 released

Symfony 7.3.1 has just been released. Read the Symfony upgrade guide to learn more about upgrading Symfony and use the SymfonyInsight upgrade reports to detect the code you will need to change in your

28 jun 2025, 9:50:14 | Symfony