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

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

pijler/validator-docs
=====================

This package provides validations for documents in Brazil.

v3.4.0(1mo ago)039MITPHPPHP ^8.3CI passing

Since Feb 29Pushed 1mo agoCompare

[ Source](https://github.com/Pijler/validator-docs)[ Packagist](https://packagist.org/packages/pijler/validator-docs)[ RSS](/packages/pijler-validator-docs/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (10)Versions (18)Used By (0)

📌 Validator Docs
================

[](#-validator-docs)

Este pacote foi inspirado em outros dois pacotes, mas foi criado pela necessidade de uma customização melhor nas messages de validação e na validação dos formatos.

- [geekcom - ValidatorDocs](https://github.com/geekcom/validator-docs)
- [LaravelLegends - PtBrValidator](https://github.com/LaravelLegends/pt-br-validator)

### 🔧 Instalação

[](#-instalação)

Para fazer a instalação do pacote, rode o comando:

```
    composer require pijler/validator-docs
```

### 📦 Customização

[](#-customização)

Nesse pacote você pode publicar as messages de validação e customizá-las, usando o comando:

```
    php artisan vendor:publish --tag="docs"
```

Caso não queira publicar o arquivo de tradução, você poderá criar suas próprias mensagens dentro do arquivo `validation.php`:

```
    'docs' => [
        'cpf' => 'Este campo deve ser um CPF válido.',
        ...
    ],
```

### 📋 Utilização

[](#-utilização)

RegrasFormatosFormatação Opcionaluf**Sem formato****`null`**cep**`99999-999`**, **`99.999-999`****`false`**cnh**Sem formato****`null`**cns**Sem formato****`null`**cpf**`999.999.999-99`****`true`**pis**`999.99999.99-9`****`true`**cnpj**`99.999.999/9999-99`****`true`**money**`99.999,99`**, **`99,999.99`****`false`**cellphone**`99999-9999`**, **`9999-9999`****`false`**telephone**`9999-9999`****`false`**cpf\_or\_cnpj**`999.999.999-99`**, **`99.999.999/9999-99`****`true`**vehicle\_plate**`AAA-1234`**, **`AAA-1A23`****`false`**cellphone\_with\_ddd**`(99)99999-9999`**, **`(99)9999-9999`**, **`(99) 99999-9999`**, **`(99) 9999-9999`****`false`**telephone\_with\_ddd**`(99)9999-9999`****`false`**cellphone\_with\_code**`+99(99)99999-9999`**, **`+99(99)9999-9999`****`false`**telephone\_with\_code**`+55(99)9999-9999`****`false`**Todas as regras podem ser utilizadas a partir da **`Rule`** do próprio Laravel:

```
    'cpf' => [
        'required',
        'string',
        Rule::cpf(),
    ],
    'cnpj' => [
        'required',
        'string',
        Rule::cnpj()->format(),
    ],
```

As regras em que existe a opção de formatação, mas é opcional, podemos aplicar a formatação de três maneiras:

```
    'cpf' => [
        'required',
        'string',
        'cpf:format',
    ],
    'cnpj' => [
        'required',
        'string',
        Rule::cnpj()->format(),
    ],
    'cpf_or_cnpj' => [
        'required',
        'string',
        (new CPForCNPJ)->format(),
    ],
```

A regra para dinheiro aceita dois parâmetros, a moeda e a localicação. Utilizamos a classe de suporte Number do próprio Laravel:

```
    'money_1' => [
        'required',
        'string',
        'money:BRL,pt_BR', // default
    ],
    'money_2' => [
        'required',
        'string',
        Rule::money()->parameters(['USD', 'en_US']),
    ],
```

Caso você precise verificar o formato do dinheiro conforme alguma regra em específica, você pode setar os callbacks no seu AppServiceProvider:

```
    Money::setLocaleCallback(function ($default) {
        return Auth::user()?->locale ?? $default;
    });

    Money::setCurrencyCallback(function ($default) {
        return Auth::user()?->currency ?? $default;
    });
```

Qualquer melhoria ou correção, poderá abrir um PR ou Issue.

### 📝 Licença

[](#-licença)

Código aberto sob a [licença MIT](LICENSE).

🚀 Obrigado!
-----------

[](#-obrigado)

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance89

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity65

Established project with proven stability

 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

Every ~50 days

Total

16

Last Release

55d ago

Major Versions

v1.7 → v2.02024-03-29

v2.1 → v3.02025-07-11

PHP version history (2 changes)v1.0PHP ^8.2

v3.4.0PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/5256615ef2ba165b92bdf89908082480fb12be597c607637262e9fe61b5b2b22?d=identicon)[joaopalopes24@gmail.com](/maintainers/joaopalopes24@gmail.com)

---

Top Contributors

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

---

Tags

laravelvalidatordocs

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

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

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

###  Alternatives

[illuminatech/validation-composite

Allows uniting several validation rules into a single one for easy re-usage

184485.5k](/packages/illuminatech-validation-composite)[stuyam/laravel-phone-validator

A phone validator for Laravel using the free Twilio phone lookup service.

2861.3k](/packages/stuyam-laravel-phone-validator)[laravel-validation-rules/us-state

Validate US States and Canada Provinces

16172.7k](/packages/laravel-validation-rules-us-state)[laravel-validation-rules/timezone

Validate that a given timezone is valid.

2119.0k](/packages/laravel-validation-rules-timezone)

PHPackages © 2026

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