PHPackages                             nerijunior/validator-docs - 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. nerijunior/validator-docs

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

nerijunior/validator-docs
=========================

Biblioteca para validação de Título de Eleitor, CPF, CNPJ, NIS e CNH

3.5.1(5y ago)06MITPHPPHP ^7.2

Since Jul 27Pushed 5y agoCompare

[ Source](https://github.com/nerijunior/validator-docs)[ Packagist](https://packagist.org/packages/nerijunior/validator-docs)[ Fund](https://gumroad.com/geekcom)[ RSS](/packages/nerijunior-validator-docs/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (7)Versions (23)Used By (0)

MEU FORK DO PROJETO ORIGINAL [geekcom/validator-docs](https://github.com/geekcom/validator-docs).

LaraValidator Docs - Brasil
===========================

[](#laravalidator-docs---brasil)

*Validação de documentos do Brasil usando **Laravel***

[![Build Status](https://camo.githubusercontent.com/525f210b76e05c41568d309450870ac7c7e9176d1cca65ca6573b8fbbe0ced1f/68747470733a2f2f7472617669732d63692e6f72672f6765656b636f6d2f76616c696461746f722d646f63732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/geekcom/validator-docs)[![Coverage Status](https://camo.githubusercontent.com/19eb6b49fef5134055f49df5a2311468209597fff30fb5c34e6d6ad28256f868/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6765656b636f6d2f76616c696461746f722d646f63732f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/geekcom/validator-docs?branch=master)[![PHPStan](https://camo.githubusercontent.com/441b5874ce4df0a2defc892979c96c46889b69cb32119d04f0b48626349f8bc9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d656e61626c65642d627269676874677265656e2e7376673f7374796c653d666c6174)](https://github.com/phpstan/phpstan)[![Total Downloads](https://camo.githubusercontent.com/0dc2a44b1ccbb5d58fe2223b2eff0e71cd138e65ad669d46a7c96fde3d4ae5b8/68747470733a2f2f706f7365722e707567782e6f72672f6765656b636f6d2f76616c696461746f722d646f63732f646f776e6c6f616473)](https://packagist.org/packages/geekcom/validator-docs)[![License](https://camo.githubusercontent.com/69c93c2bf1f17dc55c77d7b63e8adfcef6b303f2f383876401fe39b6e9a59b24/68747470733a2f2f706f7365722e707567782e6f72672f6765656b636f6d2f76616c696461746f722d646f63732f6c6963656e7365)](https://packagist.org/packages/geekcom/validator-docs)

> Para a versão compatível com Laravel 5 consulte o branch

Biblioteca Laravel para validação de CPF, CNPJ, CPF/CNPJ (quando salvos no mesmo atributo), CNH, PIS/PASEP/NIT/NIS, Inscrição Estadual, Título de Eleitor, Cartão Nacional de Saúde(CNS) e Certidões(nascimento/casamento/óbito).

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

[](#instalação)

No arquivo `composer.json`, adicione validator-docs como dependência do seu projeto:

```
"require": {
    "geekcom/validator-docs" : "^3.5"
 },

```

Depois execute:

```
composer install

```

Ou simplesmente execute o comando:

```
composer require geekcom/validator-docs

```

---

Como usar - Validações disponíveis
----------------------------------

[](#como-usar---validações-disponíveis)

Agora, você terá os métodos de validação validator docs Brasil disponíveis.

- **cpf** - Verifica se um CPF é valido.

```
$this->validate($request, [
    'cpf' => 'required|cpf',
]);
```

- **cnpj** - Verifica se um CNPJ é valido.

```
$this->validate($request, [
    'cnpj' => 'required|cnpj',
]);
```

- **cnh** - Verifica se uma CNH (Carteira Nacional de Habilitação) é válida.

```
$this->validate($request, [
    'cnh' => 'required|cnh',
]);
```

- **titulo\_eleitor** - Verifica se um Título de Eleitor é válido.

```
$this->validate($request, [
    'titulo_eleitor' => 'required|titulo_eleitor',
]);
```

- **cpf\_cnpj** - Verifica se um CPF ou CNPJ é válido.

```
$this->validate($request, [
    'cpf_cnpj' => 'required|cpf_cnpj',
]);
```

- **inscricao\_estadual** - Verifica se uma Inscrição Estadual é valida para uma unidade federarativa (UF).

```
$this->validate($request, [
    'inscricao_estadual' => 'required|inscricao_estadual:BA',
]);
```

- **nis** - Verifica se um PIS/PASEP/NIT/NIS é válido.

```
$this->validate($request, [
    'nis' => 'required|nis',
]);
```

- **cns** - Verifica se um Cartão Nciona de Saúde (CNS) é válido.

```
$this->validate($request, [
    'cns' => 'required|cns',
]);
```

- **certidao** - Verifica se uma certidão de nascimento/casamento/óbito é válida.

```
$this->validate($request, [
    'certidao' => 'required|certidao',
]);
```

- **renavam** - Verifica se o RENAVAM é válido

```
$this->validate($request, [
    'renavam' => 'required|renavam',
]);
```

- **placa** - Verifica se a PLACA é válida

```
$this->validate($request, [
    'placa' => 'required|placa',
]);
```

- **ddd** - Verifica se a DDD é válida

```
$this->validate($request, [
    'ddd' => 'required|ddd',
]);
```

- **formato\_cnpj** - Verifica se o formato de um CNPJ é válida. ( 99.999.999/9999-99 )

```
$this->validate($request, [
    'formato_cnpj' => 'required|formato_cnpj',
]);
```

- **formato\_cpf** - Verifica se o formato de um CPF é válido. ( 999.999.999-99 )

```
$this->validate($request, [
    'formato_cpf' => 'required|formato_cpf',
]);
```

- **formato\_cpf\_cnpj** - Verifica se o formato de um CPF ou um CNPJ é válido. ( 999.999.999-99 ) ou ( 99.999.999/9999-99 )

```
$this->validate($request, [
    'formato_cpf_cnpj' => 'required|formato_cpf_cnpj',
]);
```

- **formato\_nis** - Verifica se o formato de um PIS/PASEP/NIT/NIS é válido. ( 999.99999-99.9 )

```
$this->validate($request, [
    'formato_nis' => 'required|formato_nis',
]);
```

- **formato\_certidao** - Verifica se o formato de uma certidão é válida. ( 99999.99.99.9999.9.99999.999.9999999-99 ou 99999 99 99 9999 9 99999 999 9999999 99)

```
$this->validate($request, [
    'formato_certidao' => 'required|formato_certidao',
]);
```

---

Combinando validação e formato
------------------------------

[](#combinando-validação-e-formato)

No exemplo abaixo, fazemos um teste onde verificamos a formatação e a validade de um CPF ou CNPJ, para os casos onde a informação deve ser salva em um mesmo atributo:

```
$this->validate($request, [
    'cpf_or_cnpj' => 'formato_cpf_cnpj|cpf_cnpj',
]);
```

---

Exemplo de uso em um controller
-------------------------------

[](#exemplo-de-uso-em-um-controller)

Método de validação de exemplo em um controller com todas as possibilidades de validação

```
public function store(Request $request)
{
    $data = $request->all();

    $this->validate($request, [
        'cpf' => 'required|cpf',
        'cnpj' => 'required|cnpj',
        'cnh' => 'required|cnh',
        'titulo_eleitor' => 'required|titulo_eleitor',
        'nis' => 'required|nis',
        'cns' => 'required|cns',
        'renavam' => 'required|renavam',
        'placa' => 'required|placa',
        'ddd' => 'required|ddd',
    ]);

    dd($data);
}
```

---

Geradores de documentos para testes
-----------------------------------

[](#geradores-de-documentos-para-testes)

- **CNH** - [http://4devs.com.br/gerador\_de\_cnh](http://4devs.com.br/gerador_de_cnh)
- **TÍTULO ELEITORAL** - [http://4devs.com.br/gerador\_de\_titulo\_de\_eleitor](http://4devs.com.br/gerador_de_titulo_de_eleitor)
- **CNPJ** -
- **CPF** -
- **NIS** - [https://www.4devs.com.br/gerador\_de\_pis\_pasep](https://www.4devs.com.br/gerador_de_pis_pasep)
- **CNS** -
- **CERTIDÃO** -
- **INSCRIÇÃO ESTADUAL** - [https://www.4devs.com.br/gerador\_de\_inscricao\_estadual](https://www.4devs.com.br/gerador_de_inscricao_estadual)
- **RENAVAM** - [https://www.4devs.com.br/gerador\_de\_renavam](https://www.4devs.com.br/gerador_de_renavam)
- **PLACA** - [https://www.4devs.com.br/gerador\_de\_placa\_automoveis](https://www.4devs.com.br/gerador_de_placa_automoveis)

Fique a vontade para contribuir fazendo um fork.

Caso tenha alguma dúvida ou encontre algum bug, abra uma [issue](https://github.com/geekcom/validator-docs/issues) ou pesquise por issues antigas.

[Contribuidores](https://github.com/geekcom/validator-docs/graphs/contributors)
-------------------------------------------------------------------------------

[](#contribuidores)

Contribuições de qualquer tipo são bem-vindas!

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 72.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 ~74 days

Recently: every ~80 days

Total

22

Last Release

2029d ago

Major Versions

1.5.1 → 5.x-dev2019-08-14

1.5.2 → 2.0.02019-09-09

2.2.0 → 3.0.02019-10-23

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/17169?v=4)[Neri J. Jakubowski Jr.](/maintainers/nerijunior)[@nerijunior](https://github.com/nerijunior)

---

Top Contributors

[![geekcom](https://avatars.githubusercontent.com/u/3955933?v=4)](https://github.com/geekcom "geekcom (132 commits)")[![allcontributors[bot]](https://avatars.githubusercontent.com/in/23186?v=4)](https://github.com/allcontributors[bot] "allcontributors[bot] (14 commits)")[![andrergcosta](https://avatars.githubusercontent.com/u/5838239?v=4)](https://github.com/andrergcosta "andrergcosta (8 commits)")[![omarkdev](https://avatars.githubusercontent.com/u/14936241?v=4)](https://github.com/omarkdev "omarkdev (5 commits)")[![MrEko](https://avatars.githubusercontent.com/u/3877358?v=4)](https://github.com/MrEko "MrEko (5 commits)")[![lordantonelli](https://avatars.githubusercontent.com/u/7587764?v=4)](https://github.com/lordantonelli "lordantonelli (4 commits)")[![nerijunior](https://avatars.githubusercontent.com/u/17169?v=4)](https://github.com/nerijunior "nerijunior (3 commits)")[![rafael-neris](https://avatars.githubusercontent.com/u/72398144?v=4)](https://github.com/rafael-neris "rafael-neris (3 commits)")[![victorhsanjos](https://avatars.githubusercontent.com/u/12089532?v=4)](https://github.com/victorhsanjos "victorhsanjos (2 commits)")[![thicolares](https://avatars.githubusercontent.com/u/849493?v=4)](https://github.com/thicolares "thicolares (2 commits)")[![setefocos](https://avatars.githubusercontent.com/u/26557942?v=4)](https://github.com/setefocos "setefocos (1 commits)")[![Tagliatti](https://avatars.githubusercontent.com/u/4907036?v=4)](https://github.com/Tagliatti "Tagliatti (1 commits)")[![hboavent](https://avatars.githubusercontent.com/u/124891759?v=4)](https://github.com/hboavent "hboavent (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nerijunior-validator-docs/health.svg)

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

###  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)[geekcom/validator-docs

Biblioteca PHP para validação de documentos do Brasil usando Laravel

5861.2M4](/packages/geekcom-validator-docs)[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)

PHPackages © 2026

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