Download the PHP package samuelpietro/cnpjutils without Composer
On this page you can find all versions of the php package samuelpietro/cnpjutils. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download samuelpietro/cnpjutils
More information about samuelpietro/cnpjutils
Files in samuelpietro/cnpjutils
Package cnpjutils
Short Description Funções úteis para gerar e validar números de CNPJ no novo padrão alfanumérico.
License proprietary
Homepage https://github.com/SamuelPietro/cnpjutils
Informations about the package cnpjutils
CNPJUtils
CNPJUtils é uma biblioteca PHP de código aberto que oferece funções úteis para trabalhar com o novo padrão de CNPJ alfanumérico do Brasil. Esta biblioteca permite calcular dígitos verificadores e validar o formato do CNPJ conforme o novo padrão de doze caracteres alfanuméricos e dois dígitos numéricos.
Funcionalidades
- Geração de CNPJ: Cria um CNPJ aleatório que respeita o formato e as regras de validação, podendo ser usado para testes ou preenchimentos automáticos.
- Validação de CNPJ: Confirma se um CNPJ segue o formato padrão e está devidamente estruturado, validando a conformidade dos caracteres e a correta formação dos dígitos verificadores.
- Formatar/Mascarar: Formata um CNPJ alfanumérico para um formato legível, com a máscara padrão de pontuação e separação de caracteres.
- Remover mascara: Remove a formatação de um CNPJ, retornando apenas os caracteres alfanuméricos.
- Cálcular dígitos verificadores (DV): Gera os dois dígitos verificadores para um CNPJ alfanumérico, garantindo que o número esteja correto conforme as regras estabelecidas pela legislação brasileira.
Estrutura do Projeto
A estrutura do projeto é organizada para facilitar o desenvolvimento modular.
Requisitos
- PHP versão 8.0 ou superior
Instalação
- Para instalar a biblioteca via Composer, execute o seguinte comando:
Uso
-
Para gerar um CNPJ:
-
Para validar a formatação/máscara de um CNPJ:
-
Para mascarar um CNPJ:
-
Para remover a máscara de um CNPJ:
- Para calcular os dígitos verificadores de um CNPJ:
Documentação Técnica
1. Cálculo dos Dígitos Verificadores do CNPJ Alfanumérico
- O CNPJ é composto por doze caracteres alfanuméricos e dois dígitos verificadores (DV) calculados em duas etapas.
- Os pesos para o cálculo são distribuídos de 2 a 9, aplicados da direita para a esquerda, reiniciando após o oitavo dígito.
- A soma ponderada dos valores ASCII dos caracteres determina os dígitos verificadores conforme o módulo 11.
Contribuindo
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests para adicionar melhorias e novas funcionalidades.
Para enviar pull requests siga os passos abaixo.
- Faça um fork do repositório
- Crie uma branch (
git checkout -b minha-feature
) - Commit as suas alterações (
git commit -m 'Minha nova feature'
) - Envie para o repositório (
git push origin minha-feature
) - Abra um pull request
Licença
Este projeto está licenciado sob a Licença MIT, que permite o uso, modificação e distribuição do ‘software’ para qualquer finalidade, desde que a atribuição ao autor original, Samuel Pietro, seja mantida em todas as cópias, modificações ou distribuições do ‘Software’.
© 2024 Samuel Pietro / CNPJUtils