PHPackages                             lumensistemas/laravel-br-validation - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation & Sanitization](/categories/validation)
4. /
5. lumensistemas/laravel-br-validation

ActiveLibrary[Validation & Sanitization](/categories/validation)

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(3w ago)00MITPHPPHP ^8.3CI passing

Since May 17Pushed 3w agoCompare

[ Source](https://github.com/lumensistemas/laravel-br-validation)[ Packagist](https://packagist.org/packages/lumensistemas/laravel-br-validation)[ RSS](/packages/lumensistemas-laravel-br-validation/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (8)Versions (2)Used By (0)

laravel-br-validation
=====================

[](#laravel-br-validation)

[![Tests](https://github.com/lumensistemas/laravel-br-validation/actions/workflows/tests.yml/badge.svg)](https://github.com/lumensistemas/laravel-br-validation/actions/workflows/tests.yml)[![Latest Stable Version](https://camo.githubusercontent.com/bb1e5c06d0d8b3d9cc2e6c8459563537ff5409c9aeb73dd1ac28ec88864601dc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c756d656e73697374656d61732f6c61726176656c2d62722d76616c69646174696f6e2e737667)](https://packagist.org/packages/lumensistemas/laravel-br-validation)[![Total Downloads](https://camo.githubusercontent.com/05b6bd3830bd3da4b4f350fea19336263f5b7756a61058121bda2e1b91eebac1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c756d656e73697374656d61732f6c61726176656c2d62722d76616c69646174696f6e2e737667)](https://packagist.org/packages/lumensistemas/laravel-br-validation)

Laravel integration for [`lumensistemas/br-validation`](https://github.com/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
------------

[](#requirements)

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

Installation
------------

[](#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
-----

[](#usage)

### As string-named rules

[](#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

[](#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
------------

[](#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
-----------

[](#development)

```
composer install
composer test
```

License
-------

[](#license)

MIT. See [`LICENSE`](LICENSE).

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance95

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

23d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/dfdf6591a8b2d844569545878fba113e9c8de3d9b9d48f5b25637c6f0353ffbd?d=identicon)[lucasvscn](/maintainers/lucasvscn)

---

Top Contributors

[![lucasvscn](https://avatars.githubusercontent.com/u/3482569?v=4)](https://github.com/lucasvscn "lucasvscn (3 commits)")

---

Tags

laravelvalidatorvalidationphoneboletocorreioscepbrnfeDanfepixcpfcnpjbraziliansusplacacnhNISCNSbacenpistelefonefebrabandetranpasepnittitulo-eleitortserenavammercosulanatel

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/lumensistemas-laravel-br-validation/health.svg)

```
[![Health](https://phpackages.com/badges/lumensistemas-laravel-br-validation/health.svg)](https://phpackages.com/packages/lumensistemas-laravel-br-validation)
```

###  Alternatives

[propaganistas/laravel-phone

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

3.0k38.3M138](/packages/propaganistas-laravel-phone)[proengsoft/laravel-jsvalidation

Validate forms transparently with Javascript reusing your Laravel Validation Rules, Messages, and FormRequest

1.1k2.3M50](/packages/proengsoft-laravel-jsvalidation)[laravel-validation-rules/credit-card

Validate credit card number, expiration date, cvc

2462.3M6](/packages/laravel-validation-rules-credit-card)[propaganistas/laravel-disposable-email

Disposable email validator

6012.9M7](/packages/propaganistas-laravel-disposable-email)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

76318.2M110](/packages/laravel-mcp)[illuminate/validation

The Illuminate Validation package.

18837.7M1.6k](/packages/illuminate-validation)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)