mallardduck/extended-validator-laravel

An extension to Laravel's Validator class that provides some additional validation rules.

5.0.0 2024-12-21 04:19 UTC

Requires

• php: ^8.0
• composer/semver: ^3.4
• illuminate/validation: ^10.0 || ^11.0

Requires (Dev)

• brianium/paratest: ^v7.0
• 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: ^9.0
• phan/phan: ^5.2
• php-coveralls/php-coveralls: ^2.4
• phpcompatibility/php-compatibility: ^9.3
• phpstan/phpstan: ^0.12.99
• phpunit/phpunit: ^10.1
• squizlabs/php_codesniffer: ^3.6

MIT

• MallardDuck

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

• PublicIp
• PublicIpv4
• NonPublicIpv4
• NotInIf
• NotInIfValue
• PublicIpv6
• ProhibitedIf
• ProhibitedWith
• ProhibitedWithAll

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.