lumensistemas/laravel-br-validation

Laravel integration for lumensistemas/br-validation: Rule classes and named validators for Brazilian identifiers (CPF, CNPJ, PIS, Título de Eleitor, CNH, Renavam, placa, CNS, chave PIX, CEP, telefone, boleto, NF-e).

v1.0.0 2026-05-17 12:33 UTC

Requires

• php: ^8.3
• ext-mbstring: *
• illuminate/contracts: ^12.0|^13.0
• illuminate/support: ^12.0|^13.0
• illuminate/translation: ^12.0|^13.0
• illuminate/validation: ^12.0|^13.0
• lumensistemas/br-validation: ^1.0

Requires (Dev)

• lumensistemas/lens: ^1.0
• orchestra/testbench: ^10.0|^11.0
• pestphp/pest: ^4.0

MIT

• Lumen Sistemas

• validator
• validation
• phone
• laravel
• nfe
• cep
• boleto
• correios
• cpf
• cnpj
• telefone
• br
• brazilian
• pis
• febraban
• Danfe
• CNS
• placa
• detran
• sus
• cnh
• pix
• bacen
• NIS
• pasep
• nit
• titulo-eleitor
• tse
• renavam
• mercosul
• anatel

README

Laravel integration for lumensistemas/br-validation. Ships Illuminate\Contracts\Validation\ValidationRule classes and matching string-named rules (cpf, cnpj, pis, …) for every Brazilian identifier the underlying library covers.

Requirements

• PHP 8.3 or newer
• Laravel 12 or 13
• ext-mbstring

Installation

composer require lumensistemas/laravel-br-validation

The service provider is auto-discovered. Publish the translations if you want to override them:

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

Usage

As string-named rules

$request->validate([
    'cpf'              => ['required', 'cpf'],
    'cnpj'             => ['required', 'cnpj'],
    'pis'              => ['nullable', 'pis'],
    'titulo_eleitor'   => ['nullable', 'titulo_eleitor'],
    'cnh'              => ['nullable', 'cnh'],
    'renavam'          => ['nullable', 'renavam'],
    'placa'            => ['nullable', 'placa'],
    'cns'              => ['nullable', 'cns'],
    'chave_pix'        => ['nullable', 'pix'],
    'cep'              => ['required', 'cep'],
    'telefone'         => ['required', 'phone_br'],
    'boleto'           => ['required', 'boleto'],
    'nfe'              => ['required', 'nfe'],
]);

As Rule classes

use LumenSistemas\LaravelBrValidation\Rules\Cpf;
use LumenSistemas\LaravelBrValidation\Rules\Pix;

$request->validate([
    'cpf'   => ['required', new Cpf()],
    'chave' => ['required', new Pix(types: ['email', 'phone'])],
]);

Pix accepts an optional types array to restrict accepted chave PIX types (cpf, cnpj, email, phone, evp); when omitted, all five types are accepted.

Translations

Messages ship in en and pt_BR. Override per locale by publishing the language files:

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

Development

composer install
composer test

License

MIT. See LICENSE.