{"id":25750155,"url":"https://github.com/laravellegends/pt-br-validator","last_synced_at":"2025-05-14T02:04:44.879Z","repository":{"id":8929491,"uuid":"60271260","full_name":"LaravelLegends/pt-br-validator","owner":"LaravelLegends","description":"Uma biblioteca contendo validações de formatos Brasileiros, para o Laravel","archived":false,"fork":false,"pushed_at":"2025-03-12T00:37:47.000Z","size":187,"stargazers_count":616,"open_issues_count":4,"forks_count":101,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-04-10T03:45:35.128Z","etag":null,"topics":["cnpj","cpf","laravel","pt-br","validador","validar","validation"],"latest_commit_sha":null,"homepage":"https://wallacemaxters.com.br/blog/35/pt-br-validator-validacoes-em-portugues-no-laravel","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/LaravelLegends.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2016-06-02T14:33:23.000Z","updated_at":"2025-04-09T15:25:09.000Z","dependencies_parsed_at":"2024-03-18T21:34:11.963Z","dependency_job_id":"c48ab20c-43d8-43e4-8ae7-22e32041f4b4","html_url":"https://github.com/LaravelLegends/pt-br-validator","commit_stats":{"total_commits":114,"total_committers":20,"mean_commits":5.7,"dds":0.631578947368421,"last_synced_commit":"fbc431acbc508c1cfc9e836f091dc991dda62d60"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LaravelLegends%2Fpt-br-validator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LaravelLegends%2Fpt-br-validator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LaravelLegends%2Fpt-br-validator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LaravelLegends%2Fpt-br-validator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LaravelLegends","download_url":"https://codeload.github.com/LaravelLegends/pt-br-validator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254052692,"owners_count":22006716,"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":["cnpj","cpf","laravel","pt-br","validador","validar","validation"],"created_at":"2025-02-26T13:15:44.812Z","updated_at":"2025-05-14T02:04:44.840Z","avatar_url":"https://github.com/LaravelLegends.png","language":"PHP","funding_links":["https://www.paypal.com/donate/?business=KCAGBVD5TJLUL\u0026no_recurring=0\u0026item_name=Ajude+a+sustentar+algu%C3%A9m+que+apoia+o+open-source+%3A%29\u0026currency_code=BRL"],"categories":[],"sub_categories":[],"readme":"# pt-br-validator: Validações brasileiras para Laravel.\n\nEsta biblioteca adiciona validações brasileira ao Laravel, como CPF, CNPJ, Placa de Carro, CEP, Telefone, Celular e afins.\n\n:brazil::brazil::brazil:\n\n## Versões\n\n\u003ctable\u003e\n    \u003ctr\u003e    \n        \u003cth\u003eLaravel\u003c/th\u003e\n        \u003cth\u003eBiblioteca\u003c/th\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e4.*\u003c/td\u003e\n        \u003ctd\u003e4.*\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e5.*\u003c/td\u003e\n        \u003ctd\u003e5.1.*\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e^6.0 || ^7.0 || ^8.0\u003c/td\u003e\n        \u003ctd\u003e^8.0\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e^9.0\u003c/td\u003e\n        \u003ctd\u003e^9.0\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e^10.0\u003c/td\u003e\n        \u003ctd\u003e^10.0\u003c/td\u003e\n    \u003c/tr\u003e\n     \u003ctr\u003e\n        \u003ctd\u003e^11.0\u003c/td\u003e\n        \u003ctd\u003e^11.0\u003c/td\u003e\n    \u003c/tr\u003e\n     \u003ctr\u003e\n        \u003ctd\u003e^12.0\u003c/td\u003e\n        \u003ctd\u003e^12.0\u003c/td\u003e\n    \u003c/tr\u003e\n\u003c/table\u003e\n\n## Instalação\n\nNavegue até a pasta do seu projeto, por exemplo:\n\n```\ncd /etc/www/projeto\n```\n\nE então execute:\n\n```\ncomposer require laravellegends/pt-br-validator\n```\n\nCaso esteja utilizando uma versão desta biblioteca anterior a `5.2`, você deve o provider em `config/app.php`\n```php\n'providers' =\u003e [\n    // ... outros pacotes\n    LaravelLegends\\PtBrValidator\\ValidatorProvider::class\n]\n```\nAgora, para utilizar a validação, basta fazer o procedimento padrão do `Laravel`.\n\nA diferença é que será possível usar os seguintes métodos de validação:\n\n|           REGRA          |                                                                       Descrição                                                                       |\n|:-------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------:|\n| Celular                  | Valida se o campo está no formato (**`99999-9999`** ou **`9999-9999`**)                                                                               |\n| celular_com_ddd          | Valida se o campo está no formato (**`(99)99999-9999`** ou **`(99)9999-9999`** ou **`(99) 99999-9999`** ou **`(99) 9999-9999`**)                      |\n| celular_com_codigo       | Valida se o campo está no formato `+99(99)99999-9999` ou +99(99)9999-9999.                                                                            |\n| cnpj                     | Valida se o campo é um CNPJ válido. É possível gerar um CNPJ válido para seus testes utilizando o site [geradorcnpj.com](http://www.geradorcnpj.com/) |\n| cpf                      | Valida se o campo é um CPF válido. É possível gerar um CPF válido para seus testes utilizando o site [geradordecpf.org](http://geradordecpf.org)      |\n| cns                      | Valida se o campo é um CNS válido. Use o site [geradornv.com.br](https://geradornv.com.br/gerador-cns/) para testar                                   |\n| formato_cnpj             | Valida se o campo tem uma máscara de CNPJ correta (**`99.999.999/9999-99`**).                                                                         |\n| formato_cpf              | Valida se o campo tem uma máscara de CPF correta (**`999.999.999-99`**).                                                                              |\n| formato_cep              | Valida se o campo tem uma máscara de correta (**`99999-999`** ou **`99.999-999`**).                                                                   |\n| telefone                 | Valida se o campo tem umas máscara de telefone (**`9999-9999`**).                                                                                     |\n| telefone_com_ddd         | Valida se o campo tem umas máscara de telefone com DDD (**`(99)9999-9999`**).                                                                         |\n| telefone_com_codigo      | Valida se o campo tem umas máscara de telefone com DDD (**`+55(99)9999-9999`**).                                                                      |\n| formato_placa_de_veiculo | Valida se o campo tem o formato válido de uma placa de veículo (incluindo o padrão MERCOSUL).                                                         |\n| formato_pis              | Valida se o campo tem o formato de PIS.                                                                                                               |\n| pis                      | Valida se o PIS é válido.                                                                                                                             |\n| cpf_ou_cnpj              | Valida se o campo é um CPF ou CNPJ                                                                                                                    |\n| formato_cpf_ou_cnpj      | Valida se o campo contém um formato de CPF ou CNPJ                                                                                                    |\n| uf                       | Valida se o campo contém uma sigla de Estado válido (UF)                                                                                              |\n\n## Testando as validações do PtBrValidator\n\nCom isso, é possível fazer um teste simples\n\n```php\n\n$validator = \\Validator::make(\n    ['telefone' =\u003e '(77)9999-3333'],\n    ['telefone' =\u003e 'required|telefone_com_ddd']\n);\n\ndd($validator-\u003efails());\n\n```\n\nVocê pode utilizá-lo também com a instância de `Illuminate\\Http\\Request`, através do método `validate`.\n\nVeja:\n\n```php\n\nuse Illuminate\\Http\\Request;\n\n// URL: /testando?telefone=3455-1222\n\nRoute::get('testando', function (Request $request) {\n\n    try{\n\n        $dados = $request-\u003evalidate([\n            'telefone' =\u003e 'required|telefone',\n            // outras validações aqui\n        ]);\n\n    } catch (\\Illuminate\\Validation\\ValidationException $e) {\n        dd($e-\u003eerrors());\n    }\n\n});\n\n```\n\n### Customizando as mensagens\n\nTodas as validações citadas acima já contam mensagens padrões de validação, porém, é possível alterar isto usando o terceiro parâmetro de `Validator::make`. Este parâmetro deve ser um array onde os índices sejam os nomes das validações e os valores devem ser as respectivas mensagens.\n\nPor exemplo:\n\n```php\nValidator::make($valor, $regras, ['celular_com_ddd' =\u003e 'O campo :attribute não é um celular'])\n```\n\nOu através do método `messages` do seu Request criado pelo comando `php artisan make:request`.\n\n```php\npublic function messages() {\n\n    return [\n        'campo.telefone' =\u003e 'Telefone não válido!'\n    ];\n}\n```\n\n### Acessando as Regras separadamente\n\nCaso tenha necessidade de acessar alguma regra separadamente, você poderá ter acesso as seguintes classes:\n\n```\n\\LaravelLegends\\PtBrValidator\\Rules\\Celular::class\n\\LaravelLegends\\PtBrValidator\\Rules\\CelularComDdd::class\n\\LaravelLegends\\PtBrValidator\\Rules\\CelularComCodigo::class\n\\LaravelLegends\\PtBrValidator\\Rules\\Cnh::class\n\\LaravelLegends\\PtBrValidator\\Rules\\Cnpj::class\n\\LaravelLegends\\PtBrValidator\\Rules\\Cpf::class\n\\LaravelLegends\\PtBrValidator\\Rules\\Cns::class\n\\LaravelLegends\\PtBrValidator\\Rules\\FormatoCnpj::class\n\\LaravelLegends\\PtBrValidator\\Rules\\FormatoCpf::class\n\\LaravelLegends\\PtBrValidator\\Rules\\Telefone::class\n\\LaravelLegends\\PtBrValidator\\Rules\\TelefoneComDdd::class\n\\LaravelLegends\\PtBrValidator\\Rules\\TelefoneComCodigo::class\n\\LaravelLegends\\PtBrValidator\\Rules\\FormatoCep::class\n\\LaravelLegends\\PtBrValidator\\Rules\\FormatoPlacaDeVeiculo::class\n\\LaravelLegends\\PtBrValidator\\Rules\\FormatoPis::class\n\\LaravelLegends\\PtBrValidator\\Rules\\Pis::class\n\\LaravelLegends\\PtBrValidator\\Rules\\CpfOuCnpj::class\n\\LaravelLegends\\PtBrValidator\\Rules\\FormatoCpfOuCnpj::class\n\\LaravelLegends\\PtBrValidator\\Rules\\Uf::class\n```\n\nPor exemplo, se você deseja validar o formato do campo de um CPF, você pode utilizar a classe `LaravelLegends\\PtBrValidator\\Rules\\FormatoCpf` da seguinte forma:\n\n```php\nuse Illuminate\\Http\\Request;\nuse LaravelLegends\\PtBrValidator\\Rules\\FormatoCpf;\n\n// testando?cpf=valor_invalido\n\nRoute::get('testando', function (Request $request) {\n\n    try{\n\n        $dados = $request-\u003evalidate([\n            'cpf'  =\u003e ['required', new FormatoCpf]\n            // outras validações aqui\n        ]);\n\n    } catch (\\Illuminate\\Validation\\ValidationException $e) {\n        dd($e-\u003eerrors());\n    }\n\n});\n```\n\n## Changelog\n\n- 9.1.0 - Validação `cns` (cartão nacional de saúde) adicionada.\n- 8.0.3 - Validação `uf` adicionada.\n- 8.0.2 - Validação `cpf_ou_cnpj`\n- 5.2.1 - Validação `cpf_ou_cnpj`\n\n\n\n\n## Sugestões\n\n[Eloquent Filter](https://github.com/LaravelLegends/eloquent-filter): Essa biblioteca foi desenvolvida com o propósito de criar facilmente filtros de pesquisa para APIs REST. Com esta biblioteca, você vai economizar várias linhas de códigos, bem como manter um padrão global para filtros de pesquisa em sua aplicação escrita em Laravel.\n\n\n## Doações\n\n[Paypal](https://www.paypal.com/donate/?business=KCAGBVD5TJLUL\u0026no_recurring=0\u0026item_name=Ajude+a+sustentar+algu%C3%A9m+que+apoia+o+open-source+%3A%29\u0026currency_code=BRL)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaravellegends%2Fpt-br-validator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flaravellegends%2Fpt-br-validator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaravellegends%2Fpt-br-validator/lists"}