See http://symfony.com/doc/current/forms.html
Laravel integration:
- Pre-set old input
- Add validation errors
- Translate field names
See for Laravel 5.1 the 0.2 branch
composer require barryvdh/laravel-form-bridge
- Add
Barryvdh\Form\ServiceProvider::class,
to you ServiceProviders. - (optional) Add
'FormRenderer' => Barryvdh\Form\Facade\FormRenderer::class,
to your Facades. - (optional) Add
'FormFactory' => Barryvdh\Form\Facade\FormFactory::class,
to your Facades.
You can use the FormFactory to create a form. You can supply a Model as data, so it will fill the values.
You can use $form->handleRequest($request);
to update the values in the user, or you can just use $request
object or Input
facade like usual.
However, by default, the form is grouped under a form
key, so you have to use $request->get('form')
to get the form values.
Or you can create a Named form, with an empty name.
If you need to set more options, use the createBuilder
function instead of create
, to be able to use setAction()
etc. You need to call ->getForm()
to get the actual form instance again.
use Illuminate\Http\Request;
use Symfony\Component\Form\FormFactoryInterface;
use Symfony\Component\Form\Extension\Core\Type\FormType;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Extension\Core\Type\EmailType;
use Symfony\Component\Form\Extension\Core\Type\SubmitType;
Route::any('form', function(Request $request, FormFactoryInterface $factory){
$user = App\User::first();
$form = $factory->create(FormType::class, $user)
->add('name', TextType::class)
->add('email', EmailType::class)
->add('save', SubmitType::class, array('label' => 'Save user'));
$form->handleRequest($request);
if ($form->isSubmitted()) {
$v = Validator::make($request->get($form->getName()), [
'name' => 'required',
'email' => 'required|email',
]);
if ($v->fails()) {
return redirect()->back()->withInput()->withErrors($v->errors());
}
// Save the user with the new mapped data
$user->save();
}
return view('form', ['form' => $form->createView()]);
});
Use the following in your Blade templates:
@form_start($form)
@form_widget($form)
@form_end($form)
Other directives are: @form, @form_label, @form_errors, @form_rest and @form_row
@form($form)
@form_start($form)
<h2>Name</h2>
@form_label($form['name'], 'Your name')
@form_widget($form['name'], ['attr' => ['class' => 'name-input']])
<h2>Rest</h2>
@form_rest($form)
@form_end($form)
Or use the following in your Twig templates to render the view:
{{ form_start(form) }}
{{ form_widget(form) }}
{{ form_end(form) }}
See http://symfony.com/doc/current/book/forms.html#form-rendering-template for more options.
To make it easier to use in a Controller, you can use 2 traits:
ValidatesForms: Adds a validation method, similar to the ValidatesRequests trait:
$this->validateForm($form, $request, $rules)
CreatesForms: Create a Form or FormBuilder:
- createForm($type, $data, $options) -> Form for a type (
form
or a Type class) - createNamed($name, $type, $data, $options) -> Form with a given name
- createFormBuilder($data, $options) -> FormBuilder with an empty name
- createNamedFormBuilder($name, $data, $options) -> FormBuilder with a given name
use Barryvdh\Form\ValidatesForms;
use Barryvdh\Form\CreatesForms;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Extension\Core\Type\EmailType;
use Symfony\Component\Form\Extension\Core\Type\SubmitType;
class UserController extends Controller{
use ValidatesForms, CreatesForms;
public function anyIndex(Request $request)
{
$user = User::first();
$form = $this->createFormBuilder($user)
->add('name', TextType::class)
->add('email', EmailType::class)
->add('save', SubmitType::class, array('label' => 'Save user'))
->getForm();
$form->handleRequest($request);
if ($form->isSubmitted()) {
$this->validateForm($form, $request, [
'name' => 'required',
'email' => 'required|email',
]);
$user->save();
}
return view('user', ['form' => $form->createView()]);
}
}
Creating a named form:
use Symfony\Component\Form\Extension\Core\Type\FormType;
$form = $this->createNamed('user', FormType::class, $user)
->add('name', TextType::class)
->add('email', EmailType::class)
->add('save', SubmitType::class, array('label' => 'Save user'));
See http://symfony.com/doc/current/book/forms.html for more information.
BelongsToMany behaves differently, because it isn't an actual attribute on your model. Instead, we can use the custom belongs_to_many
type to fill the Form and sync it manually.
$builder
->add('users', 'belongs_to_many', [
'choices' => \App\User::lists('name', 'id'),
'expanded' => true, // true=checkboxes, false=multi select
]);
$form->handleRequest($request);
if ($form->isSubmitted()) {
$this->validate($request, $rules);
$item->save();
$item->users()->sync($request->get('users'));
return redirect()->back();
}
The belongs_to_many
type extends the choice type, but is multiple
by default.
If you want to translate your labels automatically, just pass the translation key as the label
attribute. It will run throught Twig's trans
filter.
->add('name', TextType::class, ['label' => 'fields.name'])
You can use the file
type in the FormBuilder, and use the magic getFile()
and setFile()
method on your Model or mark it as not mapped, so you can handle it yourself. See http://symfony.com/doc/current/cookbook/doctrine/file_uploads.html
Class User extends Model {
/** @var UploadedFile */
private $file;
public function getFile()
{
return $this->file;
}
public function setFile(UploadedFile $file = null)
{
$this->file = $file;
}
public function upload()
{
// the file property can be empty if the field is not required
if (null === $this->getFile()) {
return;
}
// use the original file name here but you should
// sanitize it at least to avoid any security issues
// move takes the target directory and then the
// target filename to move to
$this->getFile()->move(
$this->getUploadRootDir(),
$this->getFile()->getClientOriginalName()
);
// set the path property to the filename where you've saved the file
$this->path = $this->getFile()->getClientOriginalName();
// clean up the file property as you won't need it anymore
$this->file = null;
}
}
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Extension\Core\Type\FileType;
use Symfony\Component\Form\Extension\Core\Type\SubmitType;
$user = User::first();
$form = $this->createFormBuilder($user)
->add('name', TextType::class)
->add('file', FileType::class)
->add('save', SubmitType::class, array('label' => 'Save user'))
->getForm();
$form->handleRequest($request);
if ($form->isValid()) {
$user->upload();
$user->save();
}
You can extend some of the arrays in the ServiceProvider, eg. to add Types, add this to the register()
method in your own ServiceProvider:
$this->app->extend('form.types', function($types, $app){
$types[] = new CustomType();
return $types;
});