jeffersoncechinel / php-brdocs
PHP BrDocs auxilia na validação e formatação de documentos brasileiros como CPF e CNPJ
Installs: 17 310
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 1
Forks: 0
Open Issues: 0
Requires
- php: >=5.5
- ext-mbstring: *
Requires (Dev)
- phpunit/phpunit: ^7.5
This package is auto-updated.
Last update: 2025-04-09 22:16:23 UTC
README
Manipulação de números de documentos brasileiros de forma fácil
PHP BrDocs auxilia na validação e formatação de documentos brasileiros como CPF e CNPJ.
Documentos suportados até o momento
- CPF - Cadastro de Pessoa Física
- CNPJ - Cadastro Nacional de Pessoa Jurídica
Requisitos
- PHP >= 5.5
Instalação
Use o gerenciador de pacotes composer para instalar o BrDocs.
composer require jeffersoncechinel/php-brdocs
Exemplo de uso
Exemplos de como validar e formatar um CPF
use JC\BrDocs\BrDoc; // Verificar se um CPF é válido com input formatado var_dump(BrDoc::cpf('059.440.570-09')->isValid()); //bool(true) // Verificar se um CPF é válido com input normalizado var_dump(BrDoc::cpf('05944057009')->isValid()); //bool(true) // Normalizar o CPF antes de validar var_dump(BrDoc::cpf('5944057009')->normalize()->isValid()); //bool(true) // Formatar um CPF var_dump(BrDoc::cpf('05944057009')->format()->get()); //string(14) "059.440.570-09" // Normalizar e formatar um CPF var_dump(BrDoc::cpf('5944057009')->normalize()->format()->get()); //string(14) "059.440.570-09" // Normalizar, validar e formatar um CPF var_dump(BrDoc::cpf('5944057009')->normalize()->validate()->format()->get()); //string(14) "059.440.570-09"
Exemplos de como validar e formatar um CNPJ
use JC\BrDocs\BrDoc; // Verificar se um CNPJ é válido com input formatado var_dump(BrDoc::cnpj('03.939.810/0001-04')->isValid()); //bool(true) // Verificar se um CNPJ é válido com input normalizado var_dump(BrDoc::cnpj('03939810000104')->isValid()); //bool(true) // Normalizar o CNPJ antes de validar var_dump(BrDoc::cnpj('3939810000104')->normalize()->isValid()); //bool(true) // Formatar um CNPJ var_dump(BrDoc::cnpj('03939810000104')->format()->get()); //string(18) "03.939.810/0001-04" // Normalizar e formatar um CNPJ var_dump(BrDoc::cnpj('3939810000104')->normalize()->format()->get()); //string(18) "03.939.810/0001-04" // Normalizar, validar e formatar um CNPJ var_dump(BrDoc::cnpj('3939810000104')->normalize()->validate()->format()->get()); //string(18) "03.939.810/0001-04"
Contributing
Pull requests são bem vindos. Certifique-se de atualizar os testes apropriadamente.
Licença
Este projeto está licenciado sob a licença MIT - LICENSE