dazza-dev/laravel-batch-validation

Batch validate arrays in Laravel and optimize database unique rules using whereIn to avoid N+1 query issues.
1,056 21
Install
composer require dazza-dev/laravel-batch-validation
Latest Version:v2.2.0
PHP:>=8.2
License:MIT
Last Updated:Jun 14, 2026
Links: GitHub  ·  Packagist
Maintainer: dazza-dev

Laravel Batch Validation

When performing array validations in Laravel with unique rules, Laravel validates one record at a time, causing an N+1 query problem. This is a common issue when importing data from an Excel file and validating it before inserting it into the database. This package solves the problem by batching the unique validations and using whereIn to prevent the N+1 problem.

Install

composer require dazza-dev/laravel-batch-validation

Usage

This package is easy to use. Here's an example of how to apply it:

use Illuminate\Support\Facades\Validator;

$data = [
    ['name' => 'User 1', 'email' => 'user1@example.com'],
    ['name' => 'User 2', 'email' => 'user2@example.com'],
    ['name' => 'User 3', 'email' => 'user3@example.com'],
];

// Validator Instance
$validator = Validator::make($data, [
    '*.name' => 'required',
    '*.email' => 'email:strict|unique:contacts,email',
]);

// Validate in Batches (this prevent n+1 problem)
$validator->validateInBatches();

// Validation fails
if ($validator->fails()) {
    throw new \Exception(json_encode($validator->errors()->messages()));
}

Batch Size

You can change the batch size by passing the batchSize parameter to the validateInBatches method. The default batch size is 10.

$validator->validateInBatches(batchSize: 20);

Database Rules

This package also supports database rules like unique, exists.

$validator = Validator::make($data, [
    '*.name' => 'required',
    '*.email' => 'email:strict|unique:contacts,email',
]);

Form Request

You can use the validateInBatches method in a form request.

use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Support\Facades\Validator;

class StoreContactRequest extends FormRequest
{
    public function rules(): array
    {
        return [
            '*.name' => 'required',
            '*.email' => 'email:strict|unique:contacts,email',
        ];
    }

    public function withValidator(Validator $validator)
    {
        if (method_exists($validator, 'validateInBatches')) {
            $validator->validateInBatches(batchSize: 100);
        }
    }
}

Before and After Optimization

Before (N+1 problem)

Before Optimization

After (Optimized)

After Optimization

Contributions

Contributions are welcome. If you find any bugs or have ideas for improvements, please open an issue or send a pull request. Make sure to follow the contribution guidelines.

Author

Laravel Batch Validation was created by DAZZA.

License

This project is licensed under the MIT License.

Related Packages

skysplit/laravel5-intl-translation

Laravel 5 package for better translation syntax using php-intl extension

106,829 10
propaganistas/laravel-phone

Adds phone number functionality to Laravel based on Google's libphonenumber API.

44,002,337 3,033
prettus/laravel-validation

Laravel Validation Service

11,913,613 406
proengsoft/laravel-jsvalidation

Validate forms transparently with Javascript reusing your Laravel Validation Rul...

2,454,996 1,140
pixelpeter/laravel5-isocodes-validation

Laravel 5 wrapper for the IsoCodes Validation library from ronanguilloux

87,867 19