Download the PHP package avf/cnpj without Composer
On this page you can find all versions of the php package avf/cnpj. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package cnpj
Short Description Validador de CNPJ numérico e alfanumérico para PHP
License MIT
Homepage https://github.com/ArthurVFelipe/php-cnpj-validator
Informations about the package cnpj
AVF CNPJ Validator
Biblioteca PHP para validação, formatação e cálculo de dígitos verificadores de CNPJ.
Suporta:
- ✅ CNPJ numérico tradicional
- ✅ CNPJ alfanumérico
- ✅ Remoção de máscara
- ✅ Formatação de CNPJ
- ✅ Cálculo dos dígitos verificadores (DV)
- ✅ Compatível com PHP 8.2+
Instalação
Instale via Composer:
Requisitos
- PHP >= 8.2
- Composer
Uso básico
Após instalar, carregue o autoload do Composer:
Importe a classe principal:
Validação de CNPJ
CNPJ válido
Resultado:
CNPJ inválido
Resultado:
CNPJ Alfanumérico
A biblioteca suporta CNPJ contendo caracteres alfanuméricos na composição da base.
Exemplo:
Resultado:
Formatação do CNPJ
Transforma um CNPJ sem máscara no formato tradicional:
Resultado:
Remover máscara
Remove pontos, barras e hífen:
Resultado:
Cálculo dos dígitos verificadores
É possível calcular os dois últimos dígitos de um CNPJ.
Exemplo:
Resultado:
Com o resultado, o CNPJ completo fica:
Estrutura da biblioteca
Responsabilidades:
Cnpj
Facade pública da biblioteca.
Exemplo:
Validator
Responsável por validar o CNPJ informado.
Calculator
Responsável pelo algoritmo de cálculo dos dígitos verificadores.
Converter
Responsável pela conversão de caracteres alfanuméricos:
Exemplo:
Formatter
Responsável pela normalização e formatação:
Exemplo:
Testes
A biblioteca utiliza PHPUnit.
Instalar dependências:
Executar todos os testes:
ou:
Cobertura de testes
Os testes cobrem:
- Conversão de caracteres
- Formatação
- Remoção de máscara
- Cálculo dos dígitos verificadores
- Validação de CNPJ numérico
- Validação de CNPJ alfanumérico
- Casos inválidos
Exemplo de saída:
Exemplo completo
Licença
Este projeto está licenciado sob a licença MIT.
Consulte o arquivo LICENSE para mais detalhes.
Autor
Arthur Felipe
GitHub:
https://github.com/ArthurVFelipe
Contribuição
Contribuições são bem-vindas.
Para contribuir:
- Faça um fork do projeto
-
Crie uma branch:
- Faça suas alterações
-
Execute os testes:
- Envie um Pull Request