Laravel 5 IsoCodes Validation

, _(*1)

A simple Laravel 5 wrapper for the IsoCodes Validation library from ronanguilloux., _(*2)

For a Laravel 8 compatible version please use https://github.com/pixelpeter/laravel-isocodes-validation, _(*3)

Installation

Step 1: Install Through Composer

``` bash composer require pixelpeter/laravel5-isocodes-validation, _(*4)


### Step 2: Add the Service Provider
*(not needed starting with v2.x because of auto discovery)*

Add the service provider in `app/config/app.php`
```php
'provider' => [
    ...
    Pixelpeter\IsoCodesValidation\IsoCodesValidationServiceProvider::class,
    ...
];

Usage

Simple examples

// Checking out your e-commerce shopping cart?
$payload = [
    'creditcard' => '12345679123456'
];
$rules = [
    'creditcard' => 'creditcard'
];

$validator = Validator::make($payload, $rules);

Examples with reference parameter

Some rules need a reference to be validated against (e.g. country for zipcode)., _(*5)

Just pass the name of the field holding the reference to the rule., _(*6)

// Sending letters to the Labrador Islands ?
$payload = [
    'zipcode' => 'A0A 1A0',
    'country' => 'CA'
];
$rules = [
    'zipcode' => 'zipcode:country'
];

$validator = Validator::make($payload, $rules);

// Publishing books?
$payload = [
    'isbn' => '2-2110-4199-X',
    'isbntype' => 13
];
$rules = [
    'zipcode' => 'isbn:isbntype'
];

$validator = Validator::make($payload, $rules);

Example with arrays and dot notation

(added in v3.x), _(*7)

As suggested by @otr-tomek I've added support for all validation methods using arrays in dot notation as an input., _(*8)

$payload = [
    'data' => [
        [
            'country' => 'DE',
            'zipcode' => 63741
        ],
        [
            'country' => 'AT',
            'zipcode' => 1180
        ]
  ] 
];

$validator = Validator::make($payload, [
    'data.*.zipcode' => 'zipcode:data.*.country'
]);

Validation error messages

Error messages can contain the name and value of the field and the value of the reference, _(*9)

$payload = [
    'phonenumber' => 'invalid',
    'country' => 'GB'
];
$rules = [
    'phonenumber' => 'phonenumber:country'
];

$validator = Validator::make($payload, $rules);

print $validator->errors()->first(); // The value "invalid" of phonenumber is not valid for "GB".