mallardduck / extended-validator-laravel
An extension to Laravel's Validator class that provides some additional validation rules.
Requires
- php: ^8.0
- illuminate/validation: ^8.62 || ^9.33 || ^10.0
Requires (Dev)
- brianium/paratest: ^6.3
- dealerdirect/phpcodesniffer-composer-installer: ^0.7.0
- escapestudios/symfony2-coding-standard: ^3.11
- friendsofphp/php-cs-fixer: ^3.14
- nunomaduro/phpinsights: ^2.7
- orchestra/testbench: ^6.24 || ^7.1 || ^8.0
- phan/phan: ^5.2
- php-coveralls/php-coveralls: ^2.4
- phpcompatibility/php-compatibility: ^9.3
- phpstan/phpstan: ^0.12.99
- phpunit/phpunit: ^9.5.10
- squizlabs/php_codesniffer: ^3.6
README
An extension to Laravel's Validator class that provides some additional validation rules.
Installation
You can install the package via composer:
composer require mallardduck/extended-validator-laravel
Just require the project and Laravel's Service Provider Auto-discovery will do the rest.
All the new rules will be automatically registered for use without any configuration.
Requirements
- PHP 8.x
- Laravel 8.32.x (or greater)
Past PHP version support
Available Rules
PublicIpPublicIpv4NonPublicIpv4NotInIfNotInIfValuePublicIpv6ProhibitedIfProhibitedWithProhibitedWithAll
PublicIp
Determine if the field under validation is a valid public IP address.
Just like Laravel's ip rule, but IPs cannot be within private or reserved ranges.
$rules = [
'ip' => 'required|public_ip',
];
PublicIpv4
Determine if the field under validation is a valid public IPv4 address.
Just like Laravel's ipv4 rule, but IPs cannot be within private or reserved ranges.
$rules = [
'ip' => 'required|public_ipv4',
];
NonPublicIpv4
Determine if the field under validation is a valid non-public IPv4 address.
Just like Laravel's ipv4 rule, but IPs should only be within private or reserved ranges.
$rules = [
'ip' => 'required|non_public_ipv4',
];
NotInIf
not_in_if:anotherfield,value,...
The field under validation must not be included in the given list of values only when the given fieled is truthy.
Think of this as a conditional version of not_in rule.
$rules = [
'size' => ['sometimes', 'not_in_if_value:is_square,large,super', 'in:small,medium,large,super',],
'is_square' => ['required', 'boolean'],
];
NotInIfValue
not_in_if_value:anotherfield,anotherfield_value,value,...
The field under validation must not be included in the given list of values only when the value of the anotherfield field is equal to anotherfield_value.
Think of this as a conditional version of not_in rule.
$rules = [
'size' => ['sometimes', 'not_in_if_value:shape,square,large,super', 'in:small,medium,large,super',],
'shape' => ['required', 'in:square,rectangle'],
];
PublicIpv6
Determine if the field under validation is a valid public IPv6 address.
Just like Laravel's ipv6 rule, but IPs cannot be within private or reserved ranges.
$rules = [
'ip' => 'required|public_ipv4',
];
ProhibitedIf
It's now suggested that you use the native Laravel version of this rule. This package now requires the version that ships this, so it should be there.
For more info see the docs: https://laravel.com/docs/8.x/validation#rule-prohibited-if
Probhits aka ProhibitedWith
It's now suggested that you use the native Laravel version of this rule, even though it's slightly different. This package will require that version moving forward so the rule will be there.
For more info, see: https://laravel.com/docs/9.x/validation#rule-prohibits
ProhibitedWithAll
Use of the field under validation is prohibited only if all the other specified fields are present.
Think of it as the opposite of Laravel's required_with_all.
$rules = [
'name' => 'prohibited_with_all:first_name,middle_name,last_name',
'first_name' => 'sometimes',
'middle_name' => 'sometimes',
'last_name' => 'sometimes'
];
Testing
composer test
composer check-style
Note: The tests are great examples of potential uses for these rules.
License
The MIT License (MIT). Please see License File for more information.