README

#Commode: Validation locator

laravel-commode/validation-locator is laravel validation helper that could make your validation process more context reliable.

####Contents

Installing
Create validators
Register validators in ValidationLocator
Usage

##Installing

You can install laravel-commode/validation-locator using composer:

"require": {
    "laravel-commode/validation-locator": "dev-master"
}

To enable package you need to register LaravelCommode\ValidationLocator\ValidationLocatorServiceProvider service provider in your application config.

<?php
    // ./yourLaravelApplication/app/config/app.php
    return [
        // ... config code
        'providers' => [
            // ... providers
            'LaravelCommode\ValidationLocator\ValidationLocatorServiceProvider'
        ]
    ];

##Create validators

This approach allows you to keep your validations organized by classes to be more context reliable and reusable. To create validator you need to extend LaravelCommode\ValidationLocator\Validators\Validator and implement to public methods: getRules() and getMessages(). Method getRules() will receive $isNew boolean argument, that is used as flag if the data model is going to be created of updated, and return an array of validation rules that you usually pass to Validator facade. Method getMessages() must return an array of messages. For e.g:

<?php namespace MyApp\Meta\Validations;

    use LaravelCommode\ValidationLocator\Validators\Validator;

    class AccountValidation extends Validator
    {
        /**
        * Validated account model data, if it's flagged as new
        * password validation and confirmation will be required.
        */
        public function getRules($isNew = true)
        {
            $rules = [
                'login'     => 'required',
                'email'     => 'required'
            ];

            if ($isNew)
            {
                $rules['password'] = 'required|confirmed';
            }

            return $rules;
        }

        public function getMessages()
        {
            return [];
        }
    }

Also validator provides you an ability to register validator's 'sometimes' callback. You can simply do it by overriding sometimes() method:

    public function sometimes(\Illuminate\Validation\Validator $validator, $isNew = true)
    {
        //$validator->sometimes(); ...
    }

##Register validators in ValidationLocator

ValidationLocator is a container for keeping and resolving your validators. It is available through ValidationLocator facade, or - if you are a facade hater you can find it registered in IoC container through alias "commode.validation-locator" or can resolve LaravelCommode\ValidationLocator\Interfaces\IValidationLocator, that is registered in IoC as singleton.

To register your validator you simply need to call ValidationLocator::addValidator($alias, $className). For e.g:

<?php namespace MyApp\ServiceProviders;

    use LaravelCommode\Common\GhostService;
    use LaravelCommode\ValidationLocator\Interfaces\IValidationLocator;

    class ValidationServiceProvider extends GhostService
    {
        public function uses()
        {
            return [
                'LaravelCommode\ValidationLocator\ValidationLocatorServiceProvider'
            ];
        }

        /**
        *   Will be triggered when the app is booting
        **/
        protected function launching() { }

        /**
        *   Triggered when service is being registered
        **/
        protected function registering()
        {
            $this->with('commode.validation-locator', function (IValidationLocator $locator)
            {
                $locator->addValidator('accountManagement', 'MyApp\Meta\Validations\AccountValidation');
            });

            // or ValidationLocator::addValidator('accountManagement', 'MyApp\Meta\Validations\AccountValidation')
        }
    }

##Usage

The most simple example of using ValidationLocator is using it injected into controller:

<?php namespace MyApp\Domain\Admin\Controllers;

    use LaravelCommode\ValidationLocator\Interfaces\IValidationLocator;

    use Illuminate\Routing\Controller;

    class AccountController extends Controller
    {
        private $validationLocator;

        public function __construct(IValidationLocator $validationLocator)
        {
            $this->validationLocator = $validationLocator; // not necessary if you are using a facade
        }

        public function postCreate()
        {
            $data = \Input::only(['login', 'email', 'password', 'password_confirmation']);

            $validator = $this->validationLocator->getValidator('accountManagement');
                        // or it's available through __get()
                        // $this->validationLocator->getValidator->accountManagement;

            if ($validator->failsModel($data, true)) // or $validator->setModel($data, true)->fails()
            {
                return \Redirect::to(\URL::current())->withErrors($validator->getValidator());
                                            // return redirect with errors
            }

            // do stuff
        }

        public function postEdit()
        {
            $data = \Input::only(['login', 'email']);

            $validator = $this->validationLocator->getValidator('accountManagement');
                        // or it's available through __get()
                        // $this->validationLocator->getValidator->accountManagement;

            if ($validator->failsModel($data, true)) // or $validator->setModel($data, true)->fails()
            {
                return \Redirect::to(\URL::current())->withErrors($validator->getValidator());

            }

            // do stuff
        }
    }

laravel-commode / validation-locator

Maintainers

Details

README