Rules for ensuring that exactly 1 of n inputs is received

This package was born out of a need to ensure that for a set of inputs exactly 1 was received. Using existing validation rules could ensure that at least 1 or no more than 1 would be received, but there wasn't a succinct way of guaranteeing exactly one.

As such, two rules were implemented. The first, require_exclusive, ensures that exactly 1 of the inputs will be present. The second, optional_exclusive, allows for none of the inputs to be present but if any are present there must be exactly 1.

Installation

You can install the package via composer:

composer require thedavefulton/laravel-exclusive-validation-rules

The package is configured to use Laravel's automatic discovery. However, you can manually register the service provider in the app/config.php file:

'providers' => [
    // Other Service Providers

    Thedavefulton\ExclusiveValidationRulesServiceProvider::class,
],

Usage

These rules may be used like any standard validation rule.

$attributes= $request->validate([
    'input1' => 'required_exclusive:input2',
    'input2' => 'required_exclusive:input1',
]);

$attributes= $request->validate([
    'input1' => 'optional_exclusive:input2',
    'input2' => 'optional_exclusive:input1',
]);

They can also be extended to n inputs

$attributes= $request->validate([
    'input1' => 'required_exclusive:input2,input3,input4',
    'input2' => 'required_exclusive:input1,input3,input4',
    'input3' => 'required_exclusive:input1,input2,input4',
    'input4' => 'required_exclusive:input1,input2,input3',
]);

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• David Fulton
• All Contributors

License

The MIT License (MIT). Please see License File for more information.

Laravel Package Boilerplate

This package was generated using the Laravel Package Boilerplate.