codezero/validator

Form input validator

Form Input Validator

, _(*1)

This package provides an easy to use interface to handle server side form validation and lets you create your custom form validation classes without much effort., _(*2)

Although the core of this package is not bound to any framework, I have included a ServiceProvider and ValidationService implementation specifically for Laravel., _(*3)

I have also included a ValidationTrait and a facade (both for Laravel) so you can use this package in a way you like best (see below for more)., _(*4)

Installation

Install this package through Composer:, _(*5)

"require": {
    "codezero/validator": "1.*"
}

Laravel 4 Implementation

After installing, update your app/config/app.php file to include a reference to this package's service provider in the providers array:, _(*6)

'providers' => [
    'CodeZero\Validator\ValidatorServiceProvider'
]

This package will automatically register the Validate alias, if this is not already taken., _(*7)

You can handle failed validations by catching the ValidationException. One automated way is to add the following handler to app/start/global.php. But you could as easily catch it in a try/catch block., _(*8)

App::error(function(CodeZero\Validator\Exceptions\ValidationException $exception)
{
    return Redirect::back()->withInput()->withErrors($exception->getErrors());
});

Laravel Specific Usage

1. Create a FormValidator to validate your form

use CodeZero\Validator\FormValidator;

class UpdateUserForm extends FormValidator {

    /**
     * Validation rules
     *
     * @var array
     */ 
    protected $rules = [
        'name' => 'required',
        'email' => 'required|email|unique,email,{userId}'
    ];

}

Note the {userId} placeholder as an example., _(*9)

2. Handle the input

Create your form and then handle the input in your controller in one of the following ways., _(*10)

Validate with a facade:

$input = Input::all();
$vars = ['{userId}' => $someUser->id];

Validate::form('UpdateUserForm', $input, $vars);

You can pass the input and any placeholder key/value pairs as the second and third parameter, but if you leave both off, the package will automatically fetch Input::all() for you., _(*11)

To have typesafety or autocomplete in IDE's, you might do this instead:, _(*12)

Validate::form(get_class(UpdateUserForm), $input, $vars);

Or if you use PHP 5.5 or above, this is even cleaner:, _(*13)

Validate::form(UpdateUserForm::class, $input, $vars);

Validate with a trait:

use CodeZero\Validator\Support\ValidatorTrait;

class HomeController extends BaseController {

    use ValidatorTrait;

    public function update()
    {
        $input = Input::all();
        $vars = ['{userId}' => $someUser->id];

        $this->validate(UpdateUserForm::class, $input, $vars);

        return Redirect::to('/');
    }

}

3. Show any validation errors

Showing the errors in your form is as easy as doing this for each field:, _(*14)

{{ $errors->first('name', '<p>:message</p>'); }}

That's it!, _(*15)