bllim/laravalid

This package makes validation rules defined in laravel work client-side by converting to html/js plugins such as jquery validation. It also allows to use laravel validation messages so you can show same messages for both sides.

Saturday, February 24, 2018
by bllim
Repository
11 Watchers
55 Stars
6,198 Installations

PHP
0 Dependents
0 Suggesters
28 Forks
1 Open issues
21 Versions
11 % Grown

The README.md

Laravalid

Feature Overview

Multi-Plugin Support //For now, there is just one :)
- Jquery Validation
Extendible
Laravel form builder based
Validation rules can be set from controller
Distinguishing between numeric input and string input
User friendly input names
Remote rules such as unique and exists

Installation

Require bllim/laravalid in composer.json and run composer update., _(*2)

    {
        "require": {
            "laravel/framework": "5.2.*", //or "5.0.*"
            ...
            "bllim/laravalid": "*"
        }
        ...
    }

Note: For Laravel 4 use laravel4 branch like as "bllim/laravalid": "dev-laravel4" or "~0.9", _(*3)

Composer will download the package. After the package is downloaded, open config/app.php and add the service provider and alias as below:, _(*4)

    'providers' => array(
        ...
            Bllim\Laravalid\LaravalidServiceProvider::class,
    ),

```php 'aliases' => array( ... 'HTML' => Collective\Html\HtmlFacade::class, // if not exists add for html too 'Form' => Bllim\Laravalid\Facade::class, ),, _(*5)


Also you need to publish configuration file and assets by running the following Artisan commands.
```bash
$ php artisan vendor:publish

Configuration

After publishing configuration file, you can find it in config folder as laravalid.php file. Configuration parameters are as below:, _(*6)

Parameter	Description	Values
plugin	Choose plugin you want to use	See Plugins and Supported Rules
useLaravelMessages	If it is true, laravel validation messages are used in client side otherwise messages of chosen plugin are used	true/false
route	Route name for remote validation	Any route name (default: laravalid)

Usage

The package uses laravel Form Builder to make validation rules work for both sides. Therefore you should use Form Builder. While opening form by using Form::open you can give $rules as second parameter:, _(*7)

    $rules = ['name' => 'required|max:100', 'email' => 'required|email', 'birthdate' => 'date'];
    Form::open(array('url' => 'foo/bar', 'method' => 'put'), $rules);
    Form::text('name');
    Form::text('email');
    Form::text('birthdate');
    Form::close(); // don't forget to close form, it reset validation rules

Also if you don't want to struggle with $rules at view files, you can set it in Controller or route with or without form name by using Form::setValidation($rules, $formName). If you don't give form name, this sets rules for first Form::open, _(*8)

    // in controller or route
    $rules = ['name' => 'required|max:100', 'email' => 'required|email', 'birthdate' => 'date'];
    Form::setValidation($rules, 'firstForm'); // you can also use without giving form name Form::setValidation($rules) because there is just one.

    // in view
    Form::open(array('url' => 'foo/bar', 'method' => 'put', 'name' => 'firstForm'), $rules);
    // some form inputs
    Form::close();

For rules which is related to input type in laravel (such as max, min), the package looks for other given rules to understand which type is input. If you give integer or numeric as rule with max, min rules, the package assume input is numeric and convert to data-rule-max instead of data-rule-maxlength., _(*9)

    $rules = ['age' => 'numeric|max'];

The converter assume input is string by default. File type is also supported., _(*10)

Validation Messages, _(*11)

Converter uses validation messages of laravel (resources/lang/en/validation.php) by default for client-side too. If you want to use jquery validation messages, you can set useLaravelMessages, false in config file of package which you copied to your config dir., _(*12)

Plugins

Jquery Validation While using Jquery Validation as html/js validation plugin, you should include jquery.validate.laravalid.js in your views, too. After assets published, it will be copied to your public folder. The last thing you should do at client side is initializing jquery validation plugin as below:, _(*13)

<script type="text/javascript">
$('form').validate({onkeyup: false}); //while using remote validation, remember to set onkeyup false
</script>

Example

Controller/Route side, _(*14)

class UserController extends Controller {

    static $createValidations = ['name' => 'required|max:255', 'username' => 'required|regex:/^[a-z\-]*$/|max:20', 'email' => 'required|email', 'age' => 'numeric'];

    public function getCreate()
    {
        Form::setValidation(static::$createValidations);
        return View::make('user.create');
    }

    public function postCreate()
    {
        $inputs = Input::only(array_keys(static::$createValidations));
        $validator = Validator::make($inputs, static::$createValidations);

        if ($validator->fails())
        {
            // actually withErrors is not really necessary because we already show errors at client side for normal users
            return Redirect::back()->withErrors($validator);
        }

        // try to create user

        return Redirect::back()->with('success', 'User is created successfully');
    }
}

View side, _(*15)

<!DOCTYPE html>
<html lang="en">
    <head>
      <meta charset="utf-8">
      <title>Laravalid</title>
    </head>
    <body>

        {{ Form::open('url'=>'create', 'method'=>'post') }}
        {{ Form::text('name') }}
        {{ Form::text('username') }}
        {{ Form::email('email') }}
        {{ Form::number('age') }}
        {{ Form::close() }}

        <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.12.4/jquery.min.js"></script>
        <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery-validate/1.17.0/jquery.validate.min.js"></script>
        <script src="{{ asset('vendor/laravalid/jquery.validate.laravalid.js') }}"></script>
        <script type="text/javascript">
        $('form').validate({onkeyup: false});
        </script>
    </body>
</html>

Extending

There are two ways to extend package with your own rules. First, you can extend current converter plugin dynamically like below:, _(*16)

Form::converter()->rule()->extend('someotherrule', function($parsedRule, $attribute, $type){
    // some code
    return ['data-rule-someotherrule' => 'blablabla'];
});
Form::converter()->message()->extend('someotherrule', function($parsedRule, $attribute, $type){
    // some code
    return ['data-message-someotherrule' => 'Some other message'];
});
Form::converter()->route()->extend('someotherrule', function($name, $parameters){
    // some code
    return ['valid' => false, 'messages' => 'Seriously dude, what kind of input is this?'];
});

Second, you can create your own converter (which extends Base\Converter or any current plugin converter) in Bllim\Laravalid\Converter\ namespace and change plugin configuration in config file with your own plugin name., _(*17)

Note: If you are creating a converter for some existed html/js plugin please create it in Converter folder and send a pull-request., _(*18)

Plugins and Supported Rules

Jquery Validation To use Jquery Validation, change plugin to JqueryValidation in config file and import jquery, jquery-validation and jquery.validate.laravalid.js in views., _(*19)

Rules	Jquery Validation
Accepted	-
Active URL	`+`
After (Date)	`+`
Alpha	`+`
Alpha Dash	-
Alpha Numeric	`+`
Array	-
Before (Date)	`+`
Between	`+`
Boolean	-
Confirmed	-
Date	`+`
Date Format	-
Different	`+`
Digits	-
Digits Between	-
E-Mail	`+`
Exists (Database)	`+`
Image (File)	`+`
In	-
Integer	`+`
IP Address	`+`
Max	`+`
MIME Types	`+`
Min	`+`
Not In	-
Numeric	`+`
Regular Expression	`+`
Required	`+`
Required If	-
Required With	`+`
Required With All	-
Required Without	`+`
Required Without All	-
Same	`+`
Size	-
String	-
Timezone	-
Unique (Database)	`+`
URL	`+`

Note: It is easy to add some rules. Please check Rule class of related converter., _(*20)

Contribution

You can fork and contribute to development of the package. All pull requests is welcome., _(*21)

Conversion Logic Package converts rules by using converters (in src/Bllim/Laravalid/Converter). It uses Converter class of chosen plugin which extends Converter/Base/Converter class. You can look at existed methods and plugins to understand how it works. Explanation will be ready, soon., _(*22)

Known issues

Some rules are not supported for now

TODO

Support unsupported rules
Improve doc
Comment code

Contributors

@bllim
@phpspider
@jannispl
@rene-springmann
@nthachus

and more, _(*23)

License

Licensed under the MIT License, _(*24)

The Versions

24/02 2018

dev-master

9999999-dev

library laravalid

This package makes validation rules defined in laravel work client-side by converting to html/js plugins such as jquery validation. It also allows to use laravel validation messages so you can show same messages for both sides.

bllim/laravalid

The README.md

Laravalid

Laravel Validation For Client Side

Table of contents

Feature Overview

Installation

Configuration

Usage

Plugins

Example

Extending

Plugins and Supported Rules

Contribution

Known issues

TODO

Contributors

License

The Versions

dev-master

The Requires

The Development Requires

by Bilal Gultekin

v1.3.3

The Requires

The Development Requires

by Bilal Gultekin

dev-laravel4

The Requires

The Development Requires

by Bilal Gultekin

v0.9.2

The Requires

The Development Requires

by Bilal Gultekin

v1.3.2

The Requires

The Development Requires

by Bilal Gultekin

v1.3.1

The Requires

The Development Requires

by Bilal Gultekin

v0.9.1

The Requires

The Development Requires

by Bilal Gultekin

v1.3.0

The Requires

The Development Requires

by Bilal Gultekin

v1.2.2

The Requires

by Bilal Gultekin

v1.2.1

The Requires

by Bilal Gultekin

v1.1.2

The Requires

by Bilal Gultekin

v1.1.1

The Requires

by Bilal Gultekin

v1.1.0

The Requires

by Bilal Gultekin

v1.0.7

The Requires

by Bilal Gultekin

v1.0.6

The Requires

by Bilal Gultekin

v1.0.5

The Requires

by Bilal Gultekin

v1.0.4

The Requires

by Bilal Gultekin