PHPackages                             arielfelippi/docs-brasil - 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. [Utility & Helpers](/categories/utility)
4. /
5. arielfelippi/docs-brasil

ActiveLibrary[Utility & Helpers](/categories/utility)

arielfelippi/docs-brasil
========================

Gerenciador de documentos brasileiros, como: CPF, CNPJ, IE, CNH...

v2.1.0(2y ago)11.1k[1 PRs](https://github.com/arielfelippi/docs-brasil/pulls)MITPHPPHP >=7.4CI passing

Since Jan 27Pushed 3mo ago1 watchersCompare

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

READMEChangelog (5)Dependencies (2)Versions (7)Used By (0)

Documentação das Classes CPF, CNPJ e CPF/CNPJ
=============================================

[](#documentação-das-classes-cpf-cnpj-e-cpfcnpj)

Este arquivo contém a documentação das classes PHP relacionadas a CPF, CNPJ e CPF/CNPJ.

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

[](#instalação)

### Via composer

[](#via-composer)

```
composer require arielfelippi/docs-brasil
```

Dependência de instalação (requires)
------------------------------------

[](#dependência-de-instalação-requires)

- php: >=7.4

Dependência de instalação DEV (requires-dev)
--------------------------------------------

[](#dependência-de-instalação-dev-requires-dev)

- friendsofphp/php-cs-fixer: ^3.49
- pestphp/pest: ^2.34

Classes
-------

[](#classes)

### `Cpf`

[](#cpf)

A classe `Cpf` é responsável por manipular e validar números de CPF.

#### Exemplo de Uso

[](#exemplo-de-uso)

```
use DocsBrasil\Cpf;

// Exemplo com CPF sem máscara
$cpf = Cpf::init('12345678909');
echo $cpf->addMask(); // Saída: 123.456.789-09
echo $cpf->validate() ? 'CPF válido' : 'CPF inválido'; // Saída: CPF válido

// Exemplo com CPF com máscara
$cpfComMascara = Cpf::init('123.456.789-09');
echo $cpfComMascara->addMask(); // Saída: 123.456.789-09
echo $cpfComMascara->validate() ? 'CPF válido' : 'CPF inválido'; // Saída: CPF válido
```

### `Cnpj`

[](#cnpj)

A classe `Cnpj` é responsável por manipular e validar números de CNPJ.

#### Exemplo de Uso

[](#exemplo-de-uso-1)

```
use DocsBrasil\Cnpj;

// Exemplo com CNPJ sem máscara
$cnpj = Cnpj::init('12345678000199');
echo $cnpj->addMask(); // Saída: 12.345.678/0001-99
echo $cnpj->validate() ? 'CNPJ válido' : 'CNPJ inválido'; // Saída: CNPJ válido

// Exemplo com CNPJ com máscara
$cnpjComMascara = Cnpj::init('12.345.678/0001-99');
echo $cnpjComMascara->addMask(); // Saída: 12.345.678/0001-99
echo $cnpjComMascara->validate() ? 'CNPJ válido' : 'CNPJ inválido'; // Saída: CNPJ válido
```

### `CpfCnpj`

[](#cpfcnpj)

A classe `CpfCnpj` é responsável por manipular e validar números de CPF ou CNPJ independente do valor de entrada.

#### Exemplo de Uso

[](#exemplo-de-uso-2)

```
use DocsBrasil\CpfCnpj;

// Exemplo com CPF
$cpfCnpj = CpfCnpj::init('12345678909');
echo $cpfCnpj->addMask(); // Saída: 123.456.789-09
echo $cpfCnpj->validate() ? 'CPF válido' : 'CPF inválido'; // Saída: CPF válido

// Exemplo com CNPJ
$cpfCnpj = CpfCnpj::init('12345678000199');
echo $cpfCnpj->addMask(); // Saída: 12.345.678/0001-99
echo $cpfCnpj->validate() ? 'CNPJ válido' : 'CNPJ inválido'; // Saída: CNPJ válido

// Exemplo com CPF com máscara
$cpfCnpjComMascara = CpfCnpj::init('123.456.789-09');
echo $cpfCnpjComMascara->addMask(); // Saída: 123.456.789-09
echo $cpfCnpjComMascara->validate() ? 'CPF válido' : 'CPF inválido'; // Saída: CPF válido

// Exemplo com CNPJ com máscara
$cpfCnpjComMascara = CpfCnpj::init('12.345.678/0001-99');
echo $cpfCnpjComMascara->addMask(); // Saída: 12.345.678/0001-99
echo $cpfCnpjComMascara->validate() ? 'CNPJ válido' : 'CNPJ inválido'; // Saída: CNPJ válido
```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance54

Moderate activity, may be stable

Popularity16

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity46

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 ~8 days

Total

5

Last Release

803d ago

Major Versions

v1.2.0 → v2.0.02024-01-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/44c6e4c3620557d1b247db031bbb6ea862957bd69138eec326ac2c096814b336?d=identicon)[arielfelippi](/maintainers/arielfelippi)

---

Top Contributors

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

---

Tags

iedocsdocumentscpfcnpjbrasilcnhdocumentosdocs-brasilDocsBrasil

###  Code Quality

TestsPest

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/arielfelippi-docs-brasil/health.svg)

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

###  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)[wgenial/numeroporextenso

Converte numeral em valor por extenso.

4666.9k](/packages/wgenial-numeroporextenso)[zservices/query

Pacote para consultas em serviços do governo.

131.1k](/packages/zservices-query)

PHPackages © 2026

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