PHPackages                             jeffersoncechinel/php-brdocs - 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. jeffersoncechinel/php-brdocs

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

jeffersoncechinel/php-brdocs
============================

PHP BrDocs auxilia na validação e formatação de documentos brasileiros como CPF e CNPJ

1.0.3(4y ago)523.3k—0%MITPHPPHP >=5.5

Since Nov 26Pushed 4y ago1 watchersCompare

[ Source](https://github.com/jeffersoncechinel/php-brdocs)[ Packagist](https://packagist.org/packages/jeffersoncechinel/php-brdocs)[ RSS](/packages/jeffersoncechinel-php-brdocs/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (5)Used By (0)

PHP BrDocs
==========

[](#php-brdocs)

##### Manipulação de números de documentos brasileiros de forma fácil

[](#manipulação-de-números-de-documentos-brasileiros-de-forma-fácil)

PHP BrDocs auxilia na validação e formatação de documentos brasileiros como CPF e CNPJ.

[![License: MIT](https://camo.githubusercontent.com/1a2e0606685ce00663bf829868f794fd3fc9c86f8d80cae324734129e0723a58/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d627269676874677265656e2e737667)](https://opensource.org/licenses/MIT)

Documentos suportados até o momento
-----------------------------------

[](#documentos-suportados-até-o-momento)

- CPF - Cadastro de Pessoa Física
- CNPJ - Cadastro Nacional de Pessoa Jurídica

Requisitos
----------

[](#requisitos)

- PHP >= 5.5

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

[](#instalação)

Use o gerenciador de pacotes [composer](https://getcomposer.org/download/) para instalar o BrDocs.

```
composer require jeffersoncechinel/php-brdocs
```

Exemplo de uso
--------------

[](#exemplo-de-uso)

Exemplos de como validar e formatar um CPF

```
use JC\BrDocs\BrDoc;

// Verificar se um CPF é válido com input formatado
var_dump(BrDoc::cpf('059.440.570-09')->isValid());
//bool(true)

// Verificar se um CPF é válido com input normalizado
var_dump(BrDoc::cpf('05944057009')->isValid());
//bool(true)

// Normalizar o CPF antes de validar
var_dump(BrDoc::cpf('5944057009')->normalize()->isValid());
//bool(true)

// Formatar um CPF
var_dump(BrDoc::cpf('05944057009')->format()->get());
//string(14) "059.440.570-09"

// Normalizar e formatar um CPF
var_dump(BrDoc::cpf('5944057009')->normalize()->format()->get());
//string(14) "059.440.570-09"

// Normalizar, validar e formatar um CPF
var_dump(BrDoc::cpf('5944057009')->normalize()->validate()->format()->get());
//string(14) "059.440.570-09"
```

Exemplos de como validar e formatar um CNPJ

```
use JC\BrDocs\BrDoc;

// Verificar se um CNPJ é válido com input formatado
var_dump(BrDoc::cnpj('03.939.810/0001-04')->isValid());
//bool(true)

// Verificar se um CNPJ é válido com input normalizado
var_dump(BrDoc::cnpj('03939810000104')->isValid());
//bool(true)

// Normalizar o CNPJ antes de validar
var_dump(BrDoc::cnpj('3939810000104')->normalize()->isValid());
//bool(true)

// Formatar um CNPJ
var_dump(BrDoc::cnpj('03939810000104')->format()->get());
//string(18) "03.939.810/0001-04"

// Normalizar e formatar um CNPJ
var_dump(BrDoc::cnpj('3939810000104')->normalize()->format()->get());
//string(18) "03.939.810/0001-04"

// Normalizar, validar e formatar um CNPJ
var_dump(BrDoc::cnpj('3939810000104')->normalize()->validate()->format()->get());
//string(18) "03.939.810/0001-04"
```

Contributing
------------

[](#contributing)

Pull requests são bem vindos. Certifique-se de atualizar os testes apropriadamente.

Licença
-------

[](#licença)

Este projeto está licenciado sob a licença MIT - [LICENSE](LICENSE)

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

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

Every ~205 days

Total

3

Last Release

1590d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/63448e9184cecd0b2bdecebc3c6cabd6fc5fe2dfad983542a110d4ff8e42474d?d=identicon)[jeffersconcechinel](/maintainers/jeffersconcechinel)

---

Top Contributors

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

---

Tags

cpfcnpjValidar CPFvalidar cnpjformatar cpfformatar cnpjcpf validatorcnpj validator

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jeffersoncechinel-php-brdocs/health.svg)

```
[![Health](https://phpackages.com/badges/jeffersoncechinel-php-brdocs/health.svg)](https://phpackages.com/packages/jeffersoncechinel-php-brdocs)
```

###  Alternatives

[bissolli/validador-cpf-cnpj

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

2089.0k](/packages/bissolli-validador-cpf-cnpj)[yiibr/yii2-br-validator

Provide validations and features for brazilian localization

14103.2k4](/packages/yiibr-yii2-br-validator)

PHPackages © 2026

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