Download the PHP package cnpjcomletras/valida-cnpj-alfanumerico without Composer

On this page you can find all versions of the php package cnpjcomletras/valida-cnpj-alfanumerico. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package valida-cnpj-alfanumerico

valida-cnpj-alfanumerico (PHP)

Validação, formatação e geração de CNPJ alfanumérico (e numérico) em PHP, conforme a IN RFB nº 2.229/2024.

🔧 Prefere validar sem instalar nada? Ferramentas online gratuitas (validador, validação em lote com CSV e gerador de massa de teste) em cnpjcomletras.com.br.

Instalação

Uso

O que muda com o CNPJ alfanumérico?

Desde 31 de julho de 2026, novas inscrições podem receber CNPJ contendo letras:

Posições Conteúdo Aceita
1–8 (raiz) identificação da empresa 0-9 e A-Z
9–12 (ordem) estabelecimento 0-9 e A-Z
13–14 (DV) dígitos verificadores somente 0-9

CNPJs já emitidos não mudam. O cálculo do DV usa o mesmo módulo 11 de sempre, mas cada caractere entra com o valor ASCII − 48 ('0'→0 … '9'→9, 'A'→17 … 'Z'→42).

Sistemas que guardam CNPJ como coluna INT/BIGINT, validam com regex só-dígitos (^\d{14}$) ou fazem (int) $cnpj rejeitam ou corrompem os novos CNPJs. Guia completo de adaptação: como adaptar seu sistema · funções em Python, Java, C# e SQL.

API

Método estático Descrição
Cnpj::isValid($valor) true/false — aceita com ou sem máscara, maiúsculas ou minúsculas
Cnpj::validate($valor) array com valid, reason (se inválido), stripped, formatted, isAlphanumeric, expectedDigits
Cnpj::checkDigits($base12) calcula os 2 dígitos verificadores de uma base de 12 caracteres
Cnpj::format($valor) aplica a máscara XX.XXX.XXX/XXXX-XX
Cnpj::strip($valor) remove máscara e normaliza para maiúsculas
Cnpj::generate($alphanumeric = true, $branch = null) gera CNPJ de teste válido
Cnpj::explain($valor) array com o passo a passo do cálculo do DV (para depuração/didática)

Motivos possíveis em reason: empty, length, invalid_chars, dv_not_numeric, repeated, check_digits.

⚠️ A validação é estrutural (formato + dígitos verificadores). Ela não consulta a base da Receita Federal — um CNPJ estruturalmente válido pode não existir.

Testes

Sem dependências (roda com qualquer PHP 7.4+, sem composer install):

Com PHPUnit (composer install primeiro):

Ferramentas relacionadas

Licença

CNPJcomLetras.com.br


All versions of valida-cnpj-alfanumerico with dependencies

PHP Build Version
Package Version
Requires php Version >=7.4
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package cnpjcomletras/valida-cnpj-alfanumerico contains the following files

Loading the files please wait ...