PHPackages                             usinatech/br-validator - 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 &amp; Sanitization](/categories/validation)
4. /
5. usinatech/br-validator

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

usinatech/br-validator
======================

Uma biblioteca de validacoes brasileiras para Laravel.

v13.0.0(1mo ago)0190MITPHPPHP ^8.2CI passing

Since Jun 2Pushed 1mo agoCompare

[ Source](https://github.com/usinatech/br-validator)[ Packagist](https://packagist.org/packages/usinatech/br-validator)[ Docs](https://github.com/UsinaTech/br-validator)[ RSS](/packages/usinatech-br-validator/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (3)Dependencies (6)Versions (15)Used By (0)

br-validator
============

[](#br-validator)

Biblioteca com validacoes brasileiras para Laravel 11, 12 e 13.

Requisitos
----------

[](#requisitos)

- PHP 8.2+
- Illuminate Support 11, 12 ou 13

Instalacao
----------

[](#instalacao)

```
composer require usinatech/br-validator
```

O package provider e carregado automaticamente pelo Laravel.

Regras disponiveis
------------------

[](#regras-disponiveis)

- `celular`
- `celular_com_ddd`
- `cnh`
- `cnpj`
- `cpf`
- `data`
- `formato_cep`
- `formato_cnpj`
- `formato_cnpj_alfanumerico`
- `formato_cpf`
- `formato_placa_de_veiculo`
- `telefone`
- `telefone_com_ddd`

As regras acima usam `snake_case` como formato canonico. Alias com hifen, como `telefone-com-ddd`, continuam aceitos por compatibilidade.

Exemplo rapido
--------------

[](#exemplo-rapido)

```
$validator = \Validator::make(
    ['telefone' => '(77) 9999-3333'],
    ['telefone' => 'required|telefone_com_ddd']
);

dd($validator->fails());
```

Tambem e possivel usar as regras em requests do Laravel:

```
use Illuminate\Http\Request;

Route::get('testando', function (Request $request) {
    $dados = $request->validate([
        'telefone' => 'required|telefone',
        'cpf' => 'nullable|cpf',
    ]);

    return $dados;
});
```

Mensagens personalizadas
------------------------

[](#mensagens-personalizadas)

```
Validator::make($valor, $regras, [
    'celular_com_ddd' => 'O campo :attribute nao e um celular valido.',
]);
```

Testes
------

[](#testes)

```
composer install
composer test
```

Observacoes
-----------

[](#observacoes)

- `data` valida o formato `DD/MM/AAAA`.
- `formato_cep` aceita `99999-999` e `99.999-999`.
- `formato_cnpj` continua aceitando apenas `99.999.999/9999-99`.
- `formato_cnpj_alfanumerico` aceita tanto `99.999.999/9999-99` quanto o novo padrão com 12 posições alfanumericas e 2 digitos verificadores numericos, por exemplo `A3.08B.58C/0D01-20`.
- `formato_placa_de_veiculo` aceita `ABC-1234` e `ABC1234`.

###  Health Score

54

—

FairBetter than 96% of packages

Maintenance91

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 69.9% 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

Every ~280 days

Recently: every ~520 days

Total

14

Last Release

43d ago

Major Versions

5.1.4 → 6.0.02019-10-02

6.0.0 → 7.0.02020-04-03

7.0.0 → v8.0.02020-09-09

v8.0.2 → v10.0.02023-04-20

v10.0.0 → v13.0.02026-05-21

PHP version history (2 changes)4.2.0PHP &gt;=5.4.0

v13.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/81ac89d9bc29e3f4ed3adab8cd726e605ef5f0f7dd8fb4ac0ca8b4b4ba539b92?d=identicon)[alcimarcarlos](/maintainers/alcimarcarlos)

---

Top Contributors

[![wallacemaxters](https://avatars.githubusercontent.com/u/5245865?v=4)](https://github.com/wallacemaxters "wallacemaxters (58 commits)")[![alcimarcarlos](https://avatars.githubusercontent.com/u/15267066?v=4)](https://github.com/alcimarcarlos "alcimarcarlos (10 commits)")[![insign](https://avatars.githubusercontent.com/u/1113045?v=4)](https://github.com/insign "insign (3 commits)")[![crispossa](https://avatars.githubusercontent.com/u/889255?v=4)](https://github.com/crispossa "crispossa (2 commits)")[![brcontainer](https://avatars.githubusercontent.com/u/4368952?v=4)](https://github.com/brcontainer "brcontainer (2 commits)")[![rodrigowbazevedo](https://avatars.githubusercontent.com/u/6214250?v=4)](https://github.com/rodrigowbazevedo "rodrigowbazevedo (2 commits)")[![Dylan-DPC](https://avatars.githubusercontent.com/u/99973273?v=4)](https://github.com/Dylan-DPC "Dylan-DPC (1 commits)")[![claudsonm](https://avatars.githubusercontent.com/u/4139808?v=4)](https://github.com/claudsonm "claudsonm (1 commits)")[![Dleysson](https://avatars.githubusercontent.com/u/84591213?v=4)](https://github.com/Dleysson "Dleysson (1 commits)")[![abomfim](https://avatars.githubusercontent.com/u/205500?v=4)](https://github.com/abomfim "abomfim (1 commits)")[![jfbueno](https://avatars.githubusercontent.com/u/8502026?v=4)](https://github.com/jfbueno "jfbueno (1 commits)")[![leandroramos](https://avatars.githubusercontent.com/u/3253741?v=4)](https://github.com/leandroramos "leandroramos (1 commits)")

---

Tags

laravelvalidationcpfcnpjbrasil

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/usinatech-br-validator/health.svg)

```
[![Health](https://phpackages.com/badges/usinatech-br-validator/health.svg)](https://phpackages.com/packages/usinatech-br-validator)
```

###  Alternatives

[axlon/laravel-postal-code-validation

Worldwide postal code validation for Laravel

3893.6M1](/packages/axlon-laravel-postal-code-validation)[laravel-validation-rules/credit-card

Validate credit card number, expiration date, cvc

2462.4M7](/packages/laravel-validation-rules-credit-card)[sandermuller/laravel-fluent-validation

Fluent validation rule builders for Laravel

20518.7k4](/packages/sandermuller-laravel-fluent-validation)[robersonfaria/validation

Pacote Laravel para validações comuns ao Brasil(pt-BR) tipo: CNPJ,CPF,CEP,CNS

107.6k](/packages/robersonfaria-validation)[bissolli/validador-cpf-cnpj

Classe em PHP para validação de CPF e CNPJ.

2195.0k](/packages/bissolli-validador-cpf-cnpj)[romegasoftware/laravel-schema-generator

Generate TypeScript Zod validation schemas from Laravel validation rules

3219.4k](/packages/romegasoftware-laravel-schema-generator)

PHPackages © 2026

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