The form handlers are designed to enhance the developer experience (DX) when working with Symfony forms. It makes the controllers simpler by moving the form success and failure flows to a separate class.

class YourController extends Controller
{
    public function formAction(Request $request, MyEntityUser $user)
    {
        $handler = $this->get('hostnet.form_handler.factory')->create(MyFormHandler::class);

        if (($response = $handler->handle($request, new MyFormData())) instanceof RedirectResponse) {
            return $response;
        }

        // regular or in-valid flow
        return $this->render->renderView('/your/form.html.twig', [
            'form' => $handler->getForm()->createView()
        ]);
    }
}

By extracting the success - and if available, the failure - flows, you reduce the amount of code in your controllers, which in turn, achieves slim controllers. The definition of a controller is according to Symfony: "a PHP function you create that reads information from the Symfony's Request object and creates and returns a Response object".

Installation

• Read the installation guide when using composer.
• This bundle and the component follow semantic versioning strictly.

Documentation

• Read the Getting Started guide if you are new to form handlers.
• You can find the full documentation on our github wiki pages.
• If you are migrating from 1.1 to 1.2 or 2.x, check the migration guide.
• The legacy documentation for 1.1 is still available but upgrading is recommended.

License

The hostnet/form-handler-bundle is licensed under the MIT License, meaning you can reuse the code within proprietary software provided that all copies of the licensed software include a copy of the MIT License terms and the copyright notice.

Get in touch

• We are available on the symfony-devs slack server in #hostnet-form-handlers.
• Or via our email: [email protected].