lumensistemas/br-validation-laravel

A Laravel package that provides validation rules for Brazilian documents.

1.0.0 2026-03-27 14:50 UTC

Requires

• php: ^8.4
• illuminate/support: ^13.2

Requires (Dev)

• laravel/pint: ^1.0
• orchestra/testbench: ^11.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-type-coverage: ^4.0
• phpstan/phpstan: ^2.0
• rector/rector: ^2.0

MIT

• Lucas Vasconcelos

• validation
• laravel
• cpf
• cnpj
• lumensistemas
• br-validation-laravel

README

A Laravel package that provides validation rules for Brazilian documents such as CPF and CNPJ (including the new alphanumeric format).

Installation

You can install the package via composer:

composer require lumensistemas/br-validation-laravel

The service provider is auto-discovered by Laravel. Translations for en and pt_BR are included out of the box.

You can optionally publish the translation files:

php artisan vendor:publish --tag=br-validation-lang

Usage

CPF

use LumenSistemas\BrValidation\Rules\Cpf;

$request->validate([
    'cpf' => ['required', new Cpf],
]);

Accepts both masked (529.982.247-25) and unmasked (52998224725) formats.

CNPJ

use LumenSistemas\BrValidation\Rules\Cnpj;

$request->validate([
    'cnpj' => ['required', new Cnpj],
]);

Accepts masked (11.222.333/0001-81), unmasked (11222333000181), and alphanumeric (12ABC34501DE35) formats.

Testing

composer test:all

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Lucas Vasconcelos
• All Contributors

License

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