srlabs/validator

This package is abandoned and no longer maintained. No replacement package was suggested.

A Form Validation Class for Laravel 4

v1.0.2 2016-02-29 23:46 UTC

Requires

• php: >=5.4.0
• illuminate/support: 4.2.*
• illuminate/validation: 4.2.*

Requires (Dev)

• orchestra/testbench: 2.2.*
• phpspec/phpspec: 2.0.*@dev

MIT

• Ryan C. Durham

• validation
• laravel

README

Inspired by Laracasts' Form Validator this package provides an easy method for validating form data, including checks for unique values.

This package is no longer being maintained.

Installation

This package should be installed via composer:

$ composer require srlabs/validator

Usage

To use the form validator, first create a form class that extends SRLabs\Validator\Validation\FormValidator. This class will specify the rules and custom messages you want to use when validating this form. For example:

<?php namespace Epiphyte\Forms;

use SRLabs\Validator\Validation\FormValidator;

class UpdateProductionForm extends FormValidator {

    protected $rules = array(
        'name' => 'required|alpha|unique:productions',
        'author' => 'required'
    );

    protected $messages = array(
        'name.unique' => 'There is already a production with that name.'
    );
}

Next, inject your custom form class into the controller handling your form submission.

<?php

use Epiphyte\Forms\CreateProductionForm;
use Epiphyte\Forms\UpdateProductionForm;

class ProductionController extends \BaseController {

    protected $createProductionForm;
    protected $updateProductionForm;

    /**
     * @param CreateProductionForm $createProductionForm
     */
    public function __construct(
        CreateProductionForm $createProductionForm,
        UpdateProductionForm $updateProductionForm)
    {
        $this->createProductionForm = $createProductionForm;
        $this->updateProductionForm = $updateProductionForm;
    }

    // ...
}

To validate form data, do this in your controller method:

public function store()
{
    // Gather the Data
    $data = Input::only('name', 'author');

    // Validate the Form
    $this->createProductionForm->validate($data);

    // Create the Production
    Epiphyte\Production::create($data);

    Session::flash('success', 'Production Added');
    return Redirect::action('ProductionController@index');
}

Note that if the validation fails, an exception will be thrown (and subsequently caught) forcing a redirect back to the form, sending along the error messages and old input as well.

To validate a field containing a unique rule, pass the corresponding object to the form class:

public function update($id)
{
    $production = Epiphyte\Production::find($id);
    $data = Input::only('name', 'author');

    $this->updateProductionForm->validate($data, $production);

    $production->name = $data['name'];
    $production->author = $data['author'];
    $production->save();

    Session::flash('success', 'Production Updated');
    return Redirect::action('ProductionController@index');
}

Roadmap

• The tests need to be flushed out and greatly improved.
• Eventually I will add some config options.