phpCNPJ é uma classe escrita em PHP para validar CNPJ alfanumérico ou não, independentemente de o valor possuir máscara (99.999.999/9999-99) ou não, de acordo com as normas estabelecidas pelo governo brasileiro.
A versão 2.x introduz suporte ao novo formato de CNPJ alfanumérico.
| Versão | PHP | CNPJ alfanumérico |
|---|---|---|
1.x |
PHP 7.1+ | ❌ Não |
2.x |
PHP 8.1+ | ✅ Sim |
A versão 2.x é uma breaking change em relação à versão 1.x, principalmente por atualizar a versão mínima suportada do PHP.
Além disso, a versão 2.x passa a aceitar CNPJs alfanuméricos conforme o novo padrão da Receita Federal.
Se o seu projeto ainda utiliza PHP 7.x, utilize a última versão 1.x:
composer require vsilva472/php-cnpj:^1.0Para projetos utilizando PHP 8.1 ou superior:
composer require vsilva472/php-cnpj:^2.0- PHP 8.1+ para a versão 2.x
- PHP 7.1+ para a versão 1.x
Recomendamos a instalação via Composer. Você também pode baixar o repositório como arquivo ZIP ou fazer um clone via Git.
Para instalar a versão mais recente:
composer require vsilva472/php-cnpjPara utilizar a última versão da série 1.x:
composer require vsilva472/php-cnpj:^1.0Para utilizar a versão 2.x:
composer require vsilva472/php-cnpj:^2.0Para baixar e instalar o Composer no seu ambiente, acesse a documentação oficial do Composer.
- Baixe o repositório como ZIP ou faça um clone;
- Descompacte os arquivos em seu projeto;
- Execute o comando
composer installno local onde extraiu os arquivos.
<?php
require 'path/to/vendor/autoload.php';
$cnpj = '23.456.789/0001-55';
$validator = new \Vsilva472\phpCNPJ\CNPJ();
$isCnpjValid = $validator->validate($cnpj);
if ($isCnpjValid) {
// CNPJ válido
} else {
// CNPJ inválido
}A partir da versão 2.x, CNPJs alfanuméricos também são aceitos:
<?php
$validator = new \Vsilva472\phpCNPJ\CNPJ();
$validator->validate('00.000.000/E08G-12');Para consultar o log de alterações, acesse o arquivo CHANGELOG.md.
MIT