kris / laravel4-form-builder
Laravel form builder - symfony like
Installs: 9 049
Dependents: 0
Suggesters: 0
Security: 0
Stars: 22
Watchers: 6
Forks: 8
Open Issues: 2
Requires
- php: >=5.4.0
- illuminate/database: 4.2.*
- illuminate/html: 4.2.*
Requires (Dev)
- mockery/mockery: 0.9.*
- phpunit/phpunit: ~4.0
README
Laravel 4 form builder
Form builder for Laravel 4 inspired by Symfony's form builder. With help of Laravels FormBuilder class creates forms that can be easy modified and reused. By default it supports Bootstrap 3.
Laravel 5
For laravel 5 version check laravel-form-builder
Documentation
For detailed documentation refer to http://kristijanhusak.github.io/laravel-form-builder/.
Note There are small differences between version 4 and 5 (Configuration path, etc.), so please be aware of those.
Changelog
Changelog can be found here
###Installation
{ "require": { "kris/laravel4-form-builder": "1.6.*" } }
run composer update
Then add Service provider to config/app.php
'providers' => [ // ... 'Kris\LaravelFormBuilder\FormBuilderServiceProvider' ]
And Facade (also in config/app.php
)
'aliases' => [ // ... 'FormBuilder' => 'Kris\LaravelFormBuilder\Facades\FormBuilder' ]
Quick start
Creating form classes is easy. Lets assume PSR-4 is set for loading namespace App
in app/Project
folder. With a simple artisan command we can create form:
php artisan make:form app/Project/Forms/SongForm --fields="name:text, lyrics:textarea, publish:checkbox"
Form is created in path app/Project/Forms/SongForm.php
with content:
<?php namespace App\Forms; use Kris\LaravelFormBuilder\Form; class SongForm extends Form { public function buildForm() { $this ->add('name', 'text') ->add('lyrics', 'textarea') ->add('publish', 'checkbox'); } }
If you want to instantiate empty form without any fields, just skip passing --fields
parameter:
php artisan make:form app/Project/Forms/PostForm
Gives:
<?php namespace App\Forms; use Kris\LaravelFormBuilder\Form; class PostForm extends Form { public function buildForm() { // Add fields here... } }
After that instantiate the class in the controller and pass it to view:
<?php namespace App/Http/Controllers; use Illuminate\Routing\Controller as BaseController; use Kris\LaravelFormBuilder\FormBuilder; class SongsController extends BaseController { public function create() { $form = \FormBuilder::create('App\Forms\SongForm', [ 'method' => 'POST', 'url' => route('song.store') ]); return view('song.create', compact('form')); } }
Print the form in view with form()
helper function:
<!-- resources/views/song/create.blade.php -->
@extend('layouts.master')
@section('content')
{{{ form($form) }}}
@endsection
Above code will generate this html:
<form method="POST" action="http://example.dev/songs"> <input name="_token" type="hidden" value="FaHZmwcnaOeaJzVdyp4Ml8B6l1N1DLUDsZmsjRFL"> <div class="form-group"> <label for="name" class="control-label">Name</label> <input type="text" class="form-control" id="name"> </div> <div class="form-group"> <label for="lyrics" class="control-label">Lyrics</label> <textarea name="lyrics" class="form-control"></textarea> </div> <div class="form-group"> <label for="publish" class="control-label">Publish</label> <input type="checkbox" name="publish" id="publish"> </div> </form>
Contributing
Project follows PSR-2 standard and it's covered with PHPUnit tests. Pull requests should include tests and pass Travis CI build.
To run tests first install dependencies with composer install
.
After that tests can be run with vendor/bin/phpunit