PHPackages                             linvix-sistemas/cpf-cnpj-validator-php - 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. linvix-sistemas/cpf-cnpj-validator-php

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

linvix-sistemas/cpf-cnpj-validator-php
======================================

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

2.0.0(3w ago)1726MITPHPPHP ^7.4|^8.0

Since Jul 25Pushed 3w agoCompare

[ Source](https://github.com/linvix-sistemas/cpf-cnpj-validator-php)[ Packagist](https://packagist.org/packages/linvix-sistemas/cpf-cnpj-validator-php)[ Docs](https://github.com/linvix-sistemas/cpf-cnpj-validator-php)[ RSS](/packages/linvix-sistemas-cpf-cnpj-validator-php/feed)WikiDiscussions main Synced 2d ago

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

Validador de CPF e CNPJ
=======================

[](#validador-de-cpf-e-cnpj)

[![Build Status](https://camo.githubusercontent.com/1055258ed72c7310585537aa9de7d6897975f551ce250d979dbde8d2f1ff1086/68747470733a2f2f7472617669732d63692e6f72672f6c696e7669782d73697374656d61732f6370662d636e706a2d76616c696461746f722d7068702e7376673f6272616e63683d6d61696e)](https://travis-ci.org/linvix-sistemas/cpf-cnpj-validator-php)[![Latest Stable Version](https://camo.githubusercontent.com/f1671fca60f83ce2360df6d402247a572bcfd2d23488aebc373e072f77619dd9/68747470733a2f2f706f7365722e707567782e6f72672f6c696e7669782d73697374656d61732f6370662d636e706a2d76616c696461746f722d7068702f76)](https://packagist.org/packages/linvix-sistemas/cpf-cnpj-validator-php)[![Total Downloads](https://camo.githubusercontent.com/b76ea20666703241b928806c9ee1efe87e7493602a686554bbb37bf22f2f8f7d/68747470733a2f2f706f7365722e707567782e6f72672f6c696e7669782d73697374656d61732f6370662d636e706a2d76616c696461746f722d7068702f646f776e6c6f616473)](https://packagist.org/packages/linvix-sistemas/cpf-cnpj-validator-php)[![License](https://camo.githubusercontent.com/235e51adf0ba0d880823259d0741a60249e0b44858ff8ceddd124d413044a93e/68747470733a2f2f706f7365722e707567782e6f72672f6c696e7669782d73697374656d61732f6370662d636e706a2d76616c696461746f722d7068702f6c6963656e7365)](https://packagist.org/packages/linvix-sistemas/cpf-cnpj-validator-php)

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

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

[](#instalação)

Via [Composer](http://getcomposer.org)

```
composer require linvix-sistemas/cpf-cnpj-validator-php
```

Como utilizar
-------------

[](#como-utilizar)

Exemplo de uso para validação e formatação de CPF:

```
// Não importa se já vem formatado ou não
$document = new \LinvixSistemas\ValidadorCpfCnpj\CPF('123.456.789.00');

// Verifica se é um número válido de CPF
// Retorna true/false
$document->isValid();

// Retorna o número de CPF formatado (###.###.###-##)
// ou false caso não seja um número válido
$document->format();

// Retorna o número sem formatação alguma
$document->getValue();
```

Exemplo de uso para validação e formatação de CNPJ:

```
// Aceita tanto o formato numérico clássico quanto o novo formato alfanumérico
// da Receita Federal (letras A-Z nos 12 primeiros caracteres, dígitos verificadores
// sempre numéricos). Máscara opcional: ##.###.###/####-##
$document = new \LinvixSistemas\ValidadorCpfCnpj\CNPJ('12.345.678/0001-90');
$document = new \LinvixSistemas\ValidadorCpfCnpj\CNPJ('AB.3DE.6GH/0001-94'); // alfanumérico

// Verifica se é um número válido de CNPJ
// Retorna true/false
$document->isValid();

// Retorna o número de CNPJ formatado (##.###.###/####-##)
// ou false caso não seja um número válido
$document->format();

// Retorna o número sem formatação alguma
$document->getValue();
```

### Formato alfanumérico de CNPJ (novo padrão Receita Federal)

[](#formato-alfanumérico-de-cnpj-novo-padrão-receita-federal)

A partir do novo padrão, os 12 primeiros caracteres do CNPJ podem conter letras maiúsculas (A–Z) e dígitos (0–9). Os 2 últimos caracteres (dígitos verificadores) continuam sendo exclusivamente numéricos. A máscara permanece a mesma: `##.###.###/####-##`.

SegmentoPosiçõesConteúdoCNPJ raiz1–8A–Z e 0–9Filial9–12A–Z e 0–9Dígito verif.13–140–9```
// Exemplos de CNPJs alfanuméricos
$document = new \LinvixSistemas\ValidadorCpfCnpj\CNPJ('AB3DE6GH000194');
$document->isValid(); // true
$document->format();  // "AB.3DE.6GH/0001-94"
```

Exemplo de uso para validação e formatação de CNPJ ou CPF, já reconhecendo o tipo de documento baseado na quantidade de caracteres:

```
// Não importa se é CPF ou CNPJ e se já vem formatado (aceita alfanumérico para CNPJ)
$document = new \LinvixSistemas\ValidadorCpfCnpj\Documento('...');

// Retorna "CPF" ou "CNPJ"
$document->getType();

// Verifica se é um número válido de CNPJ ou CPF
// Retorna true/false
$document->isValid();

// Retorna o número formatado de acordo com o tipo de documento informado
// ou false caso não seja um número válido
$document->format();

// Retorna o número sem formatação alguma
$document->getValue();
```

Simples assim!

Contribuição
------------

[](#contribuição)

- Qualquer contribuição será bem vinda através de Pull Request;

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance95

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 63% 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 ~526 days

Total

3

Last Release

22d ago

Major Versions

1.0.1 → 2.0.02026-06-11

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/29714667?v=4)[Linvix Sistemas](/maintainers/dev-linvix)[@dev-linvix](https://github.com/dev-linvix)

---

Top Contributors

[![bissolli](https://avatars.githubusercontent.com/u/1808444?v=4)](https://github.com/bissolli "bissolli (29 commits)")[![cristiano-linvix](https://avatars.githubusercontent.com/u/54996308?v=4)](https://github.com/cristiano-linvix "cristiano-linvix (9 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (5 commits)")[![patrick-linvix](https://avatars.githubusercontent.com/u/227173753?v=4)](https://github.com/patrick-linvix "patrick-linvix (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

laravelcpfcnpjbrasilvalidadordocumento

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/linvix-sistemas-cpf-cnpj-validator-php/health.svg)

```
[![Health](https://phpackages.com/badges/linvix-sistemas-cpf-cnpj-validator-php/health.svg)](https://phpackages.com/packages/linvix-sistemas-cpf-cnpj-validator-php)
```

###  Alternatives

[bissolli/validador-cpf-cnpj

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

2195.0k](/packages/bissolli-validador-cpf-cnpj)[robersonfaria/validation

Pacote Laravel para validações comuns ao Brasil(pt-BR) tipo: CNPJ,CPF,CEP,CNS

107.6k](/packages/robersonfaria-validation)[yiibr/yii2-br-validator

Provide validations and features for brazilian localization

15107.1k4](/packages/yiibr-yii2-br-validator)[jailtonsc/validador-cpf-laravel

Validador de cpf com suporte para laravel 5.\*

2148.6k](/packages/jailtonsc-validador-cpf-laravel)

PHPackages © 2026

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