kris/laravel4-form-builder

Laravel form builder - symfony like

, _(*1)

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., _(*2)

Laravel 5

For laravel 5 version check laravel-form-builder, _(*3)

Documentation

For detailed documentation refer to http://kristijanhusak.github.io/laravel-form-builder/., _(*4)

Note There are small differences between version 4 and 5 (Configuration path, etc.), so please be aware of those., _(*5)

Changelog

Changelog can be found here, _(*6)

Installation

``` json { "require": { "kris/laravel4-form-builder": "1.6.*" } }, <sub>(*7)</sub>

run `composer update`

Then add Service provider to `config/app.php`

``` php
    'providers' => [
        // ...
        'Kris\LaravelFormBuilder\FormBuilderServiceProvider'
    ]

And Facade (also in config/app.php), <sub>(*8)</sub>

``` php 'aliases' => [ // ... 'FormBuilder' => 'Kris\LaravelFormBuilder\Facades\FormBuilder' ], <sub>(*9)</sub>

### 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:

```sh
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:, <sub>(*10)</sub>

<?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:, <sub>(*11)</sub>

    php artisan make:form app/Project/Forms/PostForm

Gives:, <sub>(*12)</sub>

<?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:, <sub>(*13)</sub>

<?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:, <sub>(*14)</sub>

@extend('layouts.master')

@section('content')
    {{{ form($form) }}}
@endsection

Above code will generate this html:, <sub>(*15)</sub>

<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., <sub>(*16)</sub>

To run tests first install dependencies with composer install., <sub>(*17)</sub>

After that tests can be run with vendor/bin/phpunit, <sub>(*18)</sub>