https://github.com/thunken/laravel5-isocodes-validation
Laravel 5 wrapper for the IsoCodes Validation library from ronanguilloux
https://github.com/thunken/laravel5-isocodes-validation
Last synced: 7 months ago
JSON representation
Laravel 5 wrapper for the IsoCodes Validation library from ronanguilloux
- Host: GitHub
- URL: https://github.com/thunken/laravel5-isocodes-validation
- Owner: thunken
- License: other
- Archived: true
- Fork: true (pixelpeter/laravel5-isocodes-validation)
- Created: 2020-01-22T11:54:18.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-01-22T12:18:11.000Z (over 6 years ago)
- Last Synced: 2025-11-27T16:37:48.102Z (8 months ago)
- Language: PHP
- Size: 43 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Laravel 5 IsoCodes Validation
[](https://packagist.org/packages/thunken/laravel5-isocodes-validation)
[](LICENSE.md)
[](https://travis-ci.org/thunken/laravel5-isocodes-validation)
[](https://scrutinizer-ci.com/g/thunken/laravel5-isocodes-validation)
[](https://scrutinizer-ci.com/g/thunken/laravel5-isocodes-validation)
[](https://insight.sensiolabs.com/projects/32635b20-a120-46de-a1af-4ce876bdcfbe)
[](https://packagist.org/packages/thunken/laravel5-isocodes-validation)
[](https://coveralls.io/github/thunken/laravel5-isocodes-validation?branch=master)
A simple Laravel 5 wrapper for the [IsoCodes Validation library](https://github.com/ronanguilloux/IsoCodes) from ronanguilloux.
## Installation
### Step 1: Install Through Composer
``` bash
composer require thunken/laravel5-isocodes-validation
```
### 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' => [
...
Thunken\IsoCodesValidation\IsoCodesValidationServiceProvider::class,
...
];
```
## Usage
### Simple examples
```php
// 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`).
Just pass the name of the field holding the reference to the rule.
```php
// 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)*
As suggested by @otr-tomek I've added support for all validation methods using arrays in dot notation as an input.
```php
$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
```php
$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".
```
### More Examples
Refer to [IsoCodes Validation library](https://github.com/ronanguilloux/IsoCodes) for more examples and documentation.
## Testing
Run the tests with:
```bash
vendor/bin/phpunit
```
## License
GNU General Public License v3.0 only. Please see [License File](LICENSE.md) for more information.