{"id":14975115,"url":"https://github.com/geekcom/validator-docs","last_synced_at":"2025-05-14T03:09:14.940Z","repository":{"id":37587622,"uuid":"64307903","full_name":"geekcom/validator-docs","owner":"geekcom","description":"Validação de CPF, CNPJ, CNH, NIS, DDD, Título Eleitoral e Cartão Nacional de Saúde com Laravel.","archived":false,"fork":false,"pushed_at":"2025-05-07T22:18:55.000Z","size":373,"stargazers_count":574,"open_issues_count":3,"forks_count":100,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-05-07T23:24:45.192Z","etag":null,"topics":["cnh","cnpj","cns","cpf","cpf-cnpj","hacktoberfest","laravel","laravel-package","laravel-validation","laravel10","nis","passaporte","tituloeleitor","validation","validation-library"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geekcom.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://nubank.com.br/pagar/518o5/zVBzxd00Sb"]}},"created_at":"2016-07-27T12:49:37.000Z","updated_at":"2025-05-07T22:16:39.000Z","dependencies_parsed_at":"2024-11-28T03:00:29.696Z","dependency_job_id":"c480750d-97d7-4dea-bc75-86bc701db7b4","html_url":"https://github.com/geekcom/validator-docs","commit_stats":{"total_commits":136,"total_committers":20,"mean_commits":6.8,"dds":0.4632352941176471,"last_synced_commit":"af568cbf570545fb9099ebcb1d6e108fd28cb5aa"},"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geekcom%2Fvalidator-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geekcom%2Fvalidator-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geekcom%2Fvalidator-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geekcom%2Fvalidator-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geekcom","download_url":"https://codeload.github.com/geekcom/validator-docs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254059508,"owners_count":22007768,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cnh","cnpj","cns","cpf","cpf-cnpj","hacktoberfest","laravel","laravel-package","laravel-validation","laravel10","nis","passaporte","tituloeleitor","validation","validation-library"],"created_at":"2024-09-24T13:51:32.230Z","updated_at":"2025-05-14T03:09:14.915Z","avatar_url":"https://github.com/geekcom.png","language":"PHP","funding_links":["https://nubank.com.br/pagar/518o5/zVBzxd00Sb"],"categories":[],"sub_categories":[],"readme":"# Validator Docs - Brasil\n_Biblioteca PHP para validação de documentos do Brasil usando **Laravel**_\n\n![Build Status](https://github.com/geekcom/validator-docs/actions/workflows/proposing-changes.yml/badge.svg)\n[![Coverage Status](https://coveralls.io/repos/github/geekcom/validator-docs/badge.svg)](https://coveralls.io/github/geekcom/validator-docs)\n[![PHPStan](https://img.shields.io/badge/PHPStan-enabled-brightgreen.svg?style=flat)](https://github.com/phpstan/phpstan)\n[![Monthly Downloads](http://poser.pugx.org/geekcom/validator-docs/d/monthly)](https://packagist.org/packages/geekcom/validator-docs)\n[![Total Downloads](https://poser.pugx.org/geekcom/validator-docs/downloads)](https://packagist.org/packages/geekcom/validator-docs)\n[![License](https://poser.pugx.org/geekcom/validator-docs/license)](https://packagist.org/packages/geekcom/validator-docs)\n\n\u003e ### Por favor, considere **[fazer uma doação](https://nubank.com.br/pagar/518o5/zVBzxd00Sb)**, apoie nossas atividades\n\n\u003e Para a versão legada compatível com Laravel 5 consulte o branch https://github.com/geekcom/validator-docs/tree/5.x.x\n\n## Recursos\n- Validar qualquer documento do Brasil;\n- Código testado e confiável;\n- Open Source;\n- Usado por milhares de sistemas;\n- Aprovado pela comunidade Laravel.\n\n## Instalação\nNo arquivo `composer.json`, adicione validator-docs como dependência do seu projeto:\n\n```\n\"require\": {\n    \"geekcom/validator-docs\" : \"^3.9\"\n },\n```\n\nDepois execute:\n\n```bash\ncomposer install\n```\n\nOu simplesmente execute o comando:\n\n```bash\ncomposer require geekcom/validator-docs\n```\n\n----------------------------------------------------------------------------------------------------------------------------\n\n## Testes\nPara executar os testes, basta fazer o seguinte:\n\n* Instale as dependências do projeto;\n```bash\ncomposer install\n``` \n* Execute os testes.\n```bash\ncomposer test\n```\n\n----------------------------------------------------------------------------------------------------------------------------\n\n## Como usar a biblioteca\nAgora que os métodos de validação validator-docs Brasil estão disponíveis, será possível usar da seguinte forma:\n\n* **cpf** - Verifica se um CPF é valido;\n\n```php\n$this-\u003evalidate($request, [\n    'cpf' =\u003e 'required|cpf',\n]);\n```\n\n* **cnpj** - Verifica se um CNPJ é valido;\n\n```php\n$this-\u003evalidate($request, [\n    'cnpj' =\u003e 'required|cnpj',\n]);\n```\n\n* **cnh** - Verifica se uma CNH (Carteira Nacional de Habilitação) é válida;\n\n```php\n$this-\u003evalidate($request, [\n    'cnh' =\u003e 'required|cnh',\n]);\n```\n\n* **passaporte** - Verifica se uma Passaporte Brasileiro é válido;\n\n```php\n$this-\u003evalidate($request, [\n    'passaporte' =\u003e 'required|passaporte',\n]);\n```\n\n* **titulo_eleitor** - Verifica se um Título Eleitoral é válido;\n\n```php\n$this-\u003evalidate($request, [\n    'titulo_eleitor' =\u003e 'required|titulo_eleitor',\n]);\n```\n\n* **cpf_cnpj** - Verifica se um CPF ou CNPJ é válido;\n\n```php\n$this-\u003evalidate($request, [\n    'cpf_cnpj' =\u003e 'required|cpf_cnpj',\n]);\n```\n\n* **inscricao_estadual** - Verifica se uma Inscrição Estadual é valida para uma Unidade Federativa(UF)/Estado;\n\n```php\n$this-\u003evalidate($request, [\n    'inscricao_estadual' =\u003e 'required|inscricao_estadual:UF',\n]);\n```\n\n* **nis** - Verifica se um PIS/PASEP/NIT/NIS é válido;\n\n```php\n$this-\u003evalidate($request, [\n    'nis' =\u003e 'required|nis',\n]);\n```\n\n* **cns** - Verifica se um Cartão Nacional de Saúde (CNS) é válido;\n\n```php\n$this-\u003evalidate($request, [\n    'cns' =\u003e 'required|cns',\n]);\n```\n\n* **certidao** - Verifica se uma certidão de nascimento/casamento/óbito é válida;\n\n```php\n$this-\u003evalidate($request, [\n    'certidao' =\u003e 'required|certidao',\n]);\n```\n\n* **renavam** - Verifica se um Registro Nacional de Veículos Automotores (RENAVAM) é válido;\n\n```php\n$this-\u003evalidate($request, [\n    'renavam' =\u003e 'required|renavam',\n]);\n```\n\n* **placa** - Verifica se a PLACA de um veículo é válida;\n\n```php\n$this-\u003evalidate($request, [\n    'placa' =\u003e 'required|placa',\n]);\n```\n\n* **ddd** - Verifica se um número de [DDD](https://pt.wikipedia.org/wiki/Discagem_direta_%C3%A0_dist%C3%A2ncia) é válido;\n\n```php\n$this-\u003evalidate($request, [\n    'ddd' =\u003e 'required|ddd',\n]);\n```\n\n* **formato_cnpj** - Verifica se o formato`(99.999.999/9999-99)` de um CNPJ é válido;\n\n```php\n$this-\u003evalidate($request, [\n    'formato_cnpj' =\u003e 'required|formato_cnpj',\n]);\n```\n\n* **formato_cpf** - Verifica se o formato(`999.999.999-99`) de um CPF é válido; \n\n```php\n$this-\u003evalidate($request, [\n    'formato_cpf' =\u003e 'required|formato_cpf',\n]);\n```\n\n* **formato_cpf_cnpj** - Verifica se o formato de um CPF ou de um CNPJ é válido;\n\n```php\n$this-\u003evalidate($request, [\n    'formato_cpf_cnpj' =\u003e 'required|formato_cpf_cnpj',\n]);\n```\n\n* **formato_nis** - Verifica se o formato(`999.99999-99.9`) de um PIS/PASEP/NIT/NIS é válido;\n\n```php\n$this-\u003evalidate($request, [\n    'formato_nis' =\u003e 'required|formato_nis',\n]);\n```\n\n* **formato_certidao** - Verifica se o formato(`99999.99.99.9999.9.99999.999.9999999-99` ou `99999 99 99 9999 9 99999 999 9999999 99`), de uma certidão é válida.\n\n```php\n$this-\u003evalidate($request, [\n    'formato_certidao' =\u003e 'required|formato_certidao',\n]);\n```\n----------------------------------------------------------------------------------------------------------------------------\n\n## Combinando validação e formato\nNo exemplo abaixo, fazemos um teste onde verificamos a formatação e a validade de um CPF ou CNPJ, para os casos onde a informação deve ser salva em um mesmo atributo:\n\n```php\n$this-\u003evalidate($request, [\n    'cpf_or_cnpj' =\u003e 'formato_cpf_cnpj|cpf_cnpj',\n]);\n```\n\n----------------------------------------------------------------------------------------------------------------------------\n\n## Exemplo de uso em um controller\nMétodo de validação de exemplo em um controller com todas as possibilidades de validação\n\n```php\npublic function store(Request $request)\n{\n    $data = $request-\u003eall();\n\n    $this-\u003evalidate($request, [\n        'cpf' =\u003e 'required|cpf',\n        'cnpj' =\u003e 'required|cnpj',\n        'cnh' =\u003e 'required|cnh',\n        'titulo_eleitor' =\u003e 'required|titulo_eleitor',\n        'nis' =\u003e 'required|nis',\n        'cns' =\u003e 'required|cns',\n        'ddd' =\u003e 'required|ddd',\n        'renavam' =\u003e 'required|renavam',\n        'placa' =\u003e 'required|placa',\n        'certidao' =\u003e 'required|certidao',\n        'inscricao_estadual' =\u003e 'required|inscricao_estadual:SP',\n        'passaporte' =\u003e 'required|passaporte',\n    ]);\n\n    dd($data);\n}\n```\n**Observe que para validar uma inscrição estadual é necessário informar a [UF](https://pt.wikipedia.org/wiki/Unidades_federativas_do_Brasil)**\n\n----------------------------------------------------------------------------------------------------------------------------\n\n## Geradores de documentos para testes\n* **CNH** - http://4devs.com.br/gerador_de_cnh\n* **TÍTULO ELEITORAL** - http://4devs.com.br/gerador_de_titulo_de_eleitor\n* **CNPJ** - https://geradornv.com.br/gerador-cnpj/\n* **CPF** - https://geradornv.com.br/gerador-cpf/\n* **NIS** - https://www.4devs.com.br/gerador_de_pis_pasep\n* **CNS** - https://geradornv.com.br/gerador-cns/\n* **CERTIDÕES** - https://www.4devs.com.br/gerador_numero_certidoes\n* **INSCRIÇÃO ESTADUAL** - https://www.4devs.com.br/gerador_de_inscricao_estadual\n* **RENAVAM** - https://www.4devs.com.br/gerador_de_renavam\n* **PLACA** - https://www.4devs.com.br/gerador_de_placa_automoveis\n* **Passaporte Brasileiro** - https://geradornv.com.br/gerador-passaporte/\n\nFique a vontade para contribuir de qualquer forma.\n\nCaso tenha alguma dúvida ou encontre algum bug, abra uma [issue](https://github.com/geekcom/validator-docs/issues) ou pesquise por issues antigas.\n\n## [Contribuidores](https://github.com/geekcom/validator-docs/graphs/contributors)\nContribuições de qualquer tipo são bem-vindas!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeekcom%2Fvalidator-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeekcom%2Fvalidator-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeekcom%2Fvalidator-docs/lists"}