Table of Contents

Requirements

Installation

Composer

$ composer require solidworx/form-handler-bundle:^1.0

<?php// app/AppKernel.php// ...publicfunction registerBundles()    {$bundles = [// ...newSolidWorx\FormHandler\FormHandlerBundle(),        ];// ...    )

Usage

publicfunction getForm(FormFactoryInterface$factory,Options$options);

<?phpuseSymfony\Component\Form\FormFactoryInterface;useSolidWorx\FormHandler\FormHandlerInterface;useSolidWorx\FormHandler\Options;class MyFormHandlerimplements FormHandlerInterface{publicfunctiongetForm(FormFactoryInterface$factory,Options$options)    {// eitherreturn MyFormType::class;// orreturn$factory->create(MyFormType::class);    }}

return$factory->create(MyFormType::class,null, ['horizontal' =>true]);

services:my.form.handler:class:MyFormHandlertags:            -{ name: 'form.handler' }

<?phpclass MyControllerextends Controller{publicfunctionaddAction()    {return$this->get('solidworx.form_handler')->handle(MyFormHandler::class);// MyFormHandler will automatically be pulled from the container if it is tagges with `form.handler`    }}

<?phpuseSolidWorx\FormHandler\FormRequest;useSolidWorx\FormHandler\FormHandlerInterface;useSolidWorx\FormHandler\FormHandlerFailInterface;useSymfony\Component\Form\FormErrorIterator;class MyFormHandlerimplements FormHandlerInterface, FormHandlerFailInterface{// ...publicfunctiononFail(FormRequest$formRequest,FormErrorIterator$errors,$data =null)    {// Form submission has failed, probably due to a validation error.// Handle it here if you need specific custom logic    }}

<?phpuseSolidWorx\FormHandler\FormRequest;useSolidWorx\FormHandler\FormHandlerInterface;useSolidWorx\FormHandler\FormHandlerSuccessInterface;class MyFormHandlerimplements FormHandlerInterface, FormHandlerSuccessInterface{// ...publicfunctiononSuccess($data,FormRequest$form)    {// $data is the submitted data from the form, do something with it here// This will probably save info to the DB    }}

Adding options to a form

<?phpclass MyControllerextends Controller{publicfunctionaddAction()    {return$this->get('solidworx.form_handler')->handle(MyFormHandler::class, ['entity' =>newBlog]);// MyFormHandler will automatically be pulled from the container if it is tagges with `form.handler`    }}

<?phpuseSymfony\Component\Form\FormFactoryInterface;useSolidWorx\FormHandler\FormHandlerInterface;useSolidWorx\FormHandler\Options;class MyFormHandlerimplements FormHandlerInterface{publicfunctiongetForm(FormFactoryInterface$factory,Options$options)    {return$factory->create(MyFormType::class,$options->get('entity'));    }}

<?phpuseSymfony\Component\OptionsResolver\OptionsResolver;useSolidWorx\FormHandler\FormHandlerInterface;useSolidWorx\FormHandler\FormHandlerOptionsResolver;class MyFormHandlerimplements FormHandlerInterface, FormHandlerOptionsResolver{// ...publicfunctionconfigureOptions(OptionsResolver$resolver):void    {$resolver->setRequired('entity');$resolver->addAllowedTypes('entity', BlogEntity::class);$resolver->setDefault('another_options','myvalue');    }}

Advanced Usage

Testing

$ vendor/bin/phpunit

Contributing

License