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

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

consultaazul/pt-br-validator
============================

Biblioteca para validação de formatos brasileiros. Baseado no laravellegends/pt-br-validator

030PHP

Since Sep 11Pushed 5y agoCompare

[ Source](https://github.com/consultaazul/pt-br-validator)[ Packagist](https://packagist.org/packages/consultaazul/pt-br-validator)[ RSS](/packages/consultaazul-pt-br-validator/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Validações para Português (BR) - Laravel +6
===========================================

[](#validações-para-português-br---laravel-6)

[![Travis (.com)](https://camo.githubusercontent.com/01c7aa3b2a9773970ab68615e41a6b4a6adc08d3058acb45aba48ee87018328c/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636f6d2f636f6e73756c7461617a756c2f70742d62722d76616c696461746f723f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/01c7aa3b2a9773970ab68615e41a6b4a6adc08d3058acb45aba48ee87018328c/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636f6d2f636f6e73756c7461617a756c2f70742d62722d76616c696461746f723f7374796c653d666f722d7468652d6261646765) [![GitHub](https://camo.githubusercontent.com/4271f0f12484ab4e93a7c265be8fbda1952c0bfd0abbc46fe36b94d752a3be09/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f636f6e73756c7461617a756c2f70742d62722d76616c696461746f723f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/4271f0f12484ab4e93a7c265be8fbda1952c0bfd0abbc46fe36b94d752a3be09/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f636f6e73756c7461617a756c2f70742d62722d76616c696461746f723f7374796c653d666f722d7468652d6261646765) [![Packagist Downloads](https://camo.githubusercontent.com/a929057da842536e03fa50aab2f1be991e5429f4ef748fa3cf5e0815764a1575/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f6e73756c7461617a756c2f70742d62722d76616c696461746f723f636f6c6f723d253233323438616664266c6f676f3d436f6e73756c7461253230417a756c267374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/a929057da842536e03fa50aab2f1be991e5429f4ef748fa3cf5e0815764a1575/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f6e73756c7461617a756c2f70742d62722d76616c696461746f723f636f6c6f723d253233323438616664266c6f676f3d436f6e73756c7461253230417a756c267374796c653d666f722d7468652d6261646765)

Esta é uma biblioteca com validações de dados brasileiros.

Instalação
----------

[](#instalação)

Navegue até a pasta do seu projeto e então execute:

```
composer require consultaazul/pt-br-validator

```

Agora, para utilizar a validação, você pode criar manualmente uma instância para o método `Validator::make` utilizando o facade `Illuminate\Support\Facades\Validator`É possível usar os seguintes métodos de validação:

ValidadorFormato do DadoTipo de validação`celular``99999-9999` ou `9999-9999`Formatação`celular_com_ddd``(99)99999-9999` ou `(99)9999-9999` ou `(99) 99999-9999` ou `(99) 9999-9999`Formatação`telefone``9999-9999`Formatação`telefone_com_ddd``(99)9999-9999` ou `(99) 9999-9999`Formatação`cnpj``99.999.999/9999-99` ou `99999999999999`Numérica`formato_cnpj``99.999.999/9999-99` ou `99999999999999`Formatação`cpf``999.999.999-99` ou `99999999999999`Numérica`formato_cpf``999.999.999-99`Formatação`formato_cep``99999-999` ou `99.999999-99`Formatação`formato_placa_de_veiculo``ABC-9999` ou `ABC9999`FormataçãoVocê pode utilizá-lo também com a instância de `Illuminate\Http\Request`, através do método `validate`.

```
use Illuminate\Http\Request;

// URL: /testando?telefone=3455-1222

Route::get('testando', function (Request $request) {

    try {

        $dados = $request->validate([
            'telefone' => 'required|telefone',
            // Outras validações
        ]);

    } catch (\Illuminate\Validation\ValidationException $e) {
        dd($e->errors());
    }
});
```

### Dicas:

[](#dicas)

É possível gerar números de CPF ou CNPJ válido para seus testes utilizando o site `4devs.com.br` [Gerador de CNPJ](https://www.4devs.com.br/gerador_de_cnpj) | [Gerador de CPF](https://www.4devs.com.br/gerador_de_cpf)

### Testando

[](#testando)

Com isso, é possível fazer um teste simples

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

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

### Customizando as mensagens

[](#customizando-as-mensagens)

Todas as validações citadas acima já contam mensagens padrões de validação, porém, é possível alterar isto usando o terceiro parâmetro de `Validator::make`. Este parâmetro deve ser um array onde os índices sejam os nomes das validações e os valores devem ser as respectivas mensagens.

Por exemplo:

```
Validator::make(
    ['celular_com_ddd' => '99999-9999'], // valor
    ['celular_com_ddd' => 'required|telefone_com_ddd'], // regra
    ['celular_com_ddd' => 'O campo :attribute não é um celular com ddd'] // mensagem
);
```

Ou através do método `messages` do seu Request criado pelo comando `php artisan make:request`.

```
public function messages() {
    return [
        'campo.telefone' => 'Telefone não válido!'
    ];
}
```

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity32

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/15f89d2ac5ba2e84ad52af780401cde0dd6b48a75534a4adef878046a7a7deac?d=identicon)[devmarcelosantos](/maintainers/devmarcelosantos)

---

Top Contributors

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

### Embed Badge

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

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

###  Alternatives

[webmozart/assert

Assertions to validate method input/output with nice error messages.

7.6k894.0M1.2k](/packages/webmozart-assert)[bensampo/laravel-enum

Simple, extensible and powerful enumeration implementation for Laravel.

2.0k15.9M104](/packages/bensampo-laravel-enum)[swaggest/json-schema

High definition PHP structures with JSON-schema based validation

48612.5M73](/packages/swaggest-json-schema)[stevebauman/purify

An HTML Purifier / Sanitizer for Laravel

5325.6M19](/packages/stevebauman-purify)[ashallendesign/laravel-config-validator

A package for validating your Laravel app's config.

217905.3k5](/packages/ashallendesign-laravel-config-validator)[crazybooot/base64-validation

Laravel validators for base64 encoded files

1341.9M8](/packages/crazybooot-base64-validation)

PHPackages © 2026

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