PHPackages                             esdras/cdv-cnpj-alfa - 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 &amp; Helpers](/categories/utility)
4. /
5. esdras/cdv-cnpj-alfa

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

esdras/cdv-cnpj-alfa
====================

00

Since Apr 12Compare

[ Source](https://github.com/esdrasfranca/validador-cnpj)[ Packagist](https://packagist.org/packages/esdras/cdv-cnpj-alfa)[ RSS](/packages/esdras-cdv-cnpj-alfa/feed)WikiDiscussions Synced 3w ago

READMEChangelogDependenciesVersions (1)Used By (0)

CDV-CNPJ-ALFA
=============

[](#cdv-cnpj-alfa)

Uma biblioteca PHP robusta para validar números de CNPJ (Cadastro Nacional da Pessoa Jurídica) brasileiros com suporte a caracteres alfanuméricos e tratamento abrangente de erros.

Sobre CNPJ
----------

[](#sobre-cnpj)

CNPJ (Cadastro Nacional da Pessoa Jurídica) é o número de identificação fiscal de empresas brasileiras. O formato padrão do CNPJ é `XX.XXX.XXX/XXXX-XX`, consistindo em 14 caracteres que podem incluir dígitos (0-9) e letras (A-Z).

Esta biblioteca valida números de CNPJ através de:

- Verificação do formato correto (14 caracteres alfanuméricos)
- Validação dos dois dígitos verificadores usando o algoritmo oficial
- Detecção e rejeição de padrões inválidos

Características
---------------

[](#características)

✨ **Validação Completa de CNPJ**

- Valida números de CNPJ com 14 caracteres alfanuméricos
- Calcula e verifica ambos os dígitos verificadores
- Suporta caracteres alfanuméricos com variação de maiúsculas e minúsculas

🛡️ **Tratamento Robusto de Erros**

- Exceções dedicadas para diferentes cenários de erro
- Mensagens de erro claras para depuração
- Sanitização e normalização de entrada

🔧 **Fácil Integração**

- API simples e intuitiva
- Compatibilidade com autoloading PSR-4
- Sem dependências externas

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

[](#instalação)

### Via Composer

[](#via-composer)

```
composer require esdras/cdv-cnpj-alfa
```

### Instalação Manual

[](#instalação-manual)

1. Clone ou faça download do projeto
2. Inclua o autoloader no seu arquivo PHP:

```
require_once __DIR__ . '/vendor/autoload.php';
```

Uso
---

[](#uso)

### Validação Básica

[](#validação-básica)

```
