PHPackages aluisio-pires/pt-br-validator - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Validation & Sanitization](/categories/validation) 4. / 5. aluisio-pires/pt-br-validator ActiveLibrary[Validation & Sanitization](/categories/validation) aluisio-pires/pt-br-validator ============================= Uma biblioteca contendo validações de formatos Brasileiros, para o Laravel 11.0.0(2y ago)09MITPHP Since Jun 2Pushed 2y agoCompare [ Source](https://github.com/Aluisio-Pires/pt-br-validator)[ Packagist](https://packagist.org/packages/aluisio-pires/pt-br-validator)[ RSS](/packages/aluisio-pires-pt-br-validator/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (3)Versions (26)Used By (0) pt-br-validator: Validações brasileiras para Laravel. ===================================================== [](#pt-br-validator-validações-brasileiras-para-laravel) Esta biblioteca adiciona validações brasileira ao Laravel, como CPF, CNPJ, Placa de Carro, CEP, Telefone, Celular e afins. 🇧🇷🇧🇷🇧🇷 Versões ------- [](#versões) Laravel Biblioteca 4.\* 4.\* 5.\* 5.1.\* ^6.0 || ^7.0 || ^8.0 ^8.0 ^9.0 ^9.0 ^10.0 ^10.0 Instalação ---------- [](#instalação) Navegue até a pasta do seu projeto, por exemplo: ``` cd /etc/www/projeto ``` E então execute: ``` composer require laravellegends/pt-br-validator ``` Caso esteja utilizando uma versão desta biblioteca anterior a `5.2`, você deve o provider em `config/app.php` ``` 'providers' => [ // ... outros pacotes LaravelLegends\PtBrValidator\ValidatorProvider::class ] ``` Agora, para utilizar a validação, basta fazer o procedimento padrão do `Laravel`. A diferença é que será possível usar os seguintes métodos de validação: REGRADescriçãoCelularValida se o campo está no formato (**`99999-9999`** ou **`9999-9999`**)celular\_com\_dddValida se o campo está no formato (**`(99)99999-9999`** ou **`(99)9999-9999`** ou **`(99) 99999-9999`** ou **`(99) 9999-9999`**)celular\_com\_codigoValida se o campo está no formato `+99(99)99999-9999` ou +99(99)9999-9999.cnpjValida 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/)cpfValida 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)cnsValida se o campo é um CNS válido. Use o site [geradornv.com.br](https://geradornv.com.br/gerador-cns/) para testarformato\_cnpjValida se o campo tem uma máscara de CNPJ correta (**`99.999.999/9999-99`**).formato\_cpfValida se o campo tem uma máscara de CPF correta (**`999.999.999-99`**).formato\_cepValida se o campo tem uma máscara de correta (**`99999-999`** ou **`99.999-999`**).telefoneValida se o campo tem umas máscara de telefone (**`9999-9999`**).telefone\_com\_dddValida se o campo tem umas máscara de telefone com DDD (**`(99)9999-9999`**).telefone\_com\_codigoValida se o campo tem umas máscara de telefone com DDD (**`+55(99)9999-9999`**).formato\_placa\_de\_veiculoValida se o campo tem o formato válido de uma placa de veículo (incluindo o padrão MERCOSUL).formato\_pisValida se o campo tem o formato de PIS.pisValida se o PIS é válido.cpf\_ou\_cnpjValida se o campo é um CPF ou CNPJformato\_cpf\_ou\_cnpjValida se o campo contém um formato de CPF ou CNPJufValida se o campo contém uma sigla de Estado válido (UF)Testando as validações do PtBrValidator --------------------------------------- [](#testando-as-validações-do-ptbrvalidator) Com isso, é possível fazer um teste simples ``` $validator = \Validator::make( ['telefone' => '(77)9999-3333'], ['telefone' => 'required|telefone_com_ddd'] ); dd($validator->fails()); ``` Você pode utilizá-lo também com a instância de `Illuminate\Http\Request`, através do método `validate`. Veja: ``` use Illuminate\Http\Request; // URL: /testando?telefone=3455-1222 Route::get('testando', function (Request $request) { try{ $dados = $request->validate([ 'telefone' => 'required|telefone', // outras validações aqui ]); } catch (\Illuminate\Validation\ValidationException $e) { dd($e->errors()); } }); ``` ### Customizando as mensagens [](#customizando-as-mensagens) Todas 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. Por exemplo: ``` Validator::make($valor, $regras, ['celular_com_ddd' => 'O campo :attribute não é um celular']) ``` Ou através do método `messages` do seu Request criado pelo comando `php artisan make:request`. ``` public function messages() { return [ 'campo.telefone' => 'Telefone não válido!' ]; } ``` ### Acessando as Regras separadamente [](#acessando-as-regras-separadamente) Caso tenha necessidade de acessar alguma regra separadamente, você poderá ter acesso as seguintes classes: ``` \LaravelLegends\PtBrValidator\Rules\Celular::class \LaravelLegends\PtBrValidator\Rules\CelularComDdd::class \LaravelLegends\PtBrValidator\Rules\CelularComCodigo::class \LaravelLegends\PtBrValidator\Rules\Cnh::class \LaravelLegends\PtBrValidator\Rules\Cnpj::class \LaravelLegends\PtBrValidator\Rules\Cpf::class \LaravelLegends\PtBrValidator\Rules\Cns::class \LaravelLegends\PtBrValidator\Rules\FormatoCnpj::class \LaravelLegends\PtBrValidator\Rules\FormatoCpf::class \LaravelLegends\PtBrValidator\Rules\Telefone::class \LaravelLegends\PtBrValidator\Rules\TelefoneComDdd::class \LaravelLegends\PtBrValidator\Rules\TelefoneComCodigo::class \LaravelLegends\PtBrValidator\Rules\FormatoCep::class \LaravelLegends\PtBrValidator\Rules\FormatoPlacaDeVeiculo::class \LaravelLegends\PtBrValidator\Rules\FormatoPis::class \LaravelLegends\PtBrValidator\Rules\Pis::class \LaravelLegends\PtBrValidator\Rules\CpfOuCnpj::class \LaravelLegends\PtBrValidator\Rules\FormatoCpfOuCnpj::class \LaravelLegends\PtBrValidator\Rules\Uf::class ``` Por exemplo, se você deseja validar o formato do campo de um CPF, você pode utilizar a classe `LaravelLegends\PtBrValidator\Rules\FormatoCpf` da seguinte forma: ``` use Illuminate\Http\Request; use LaravelLegends\PtBrValidator\Rules\FormatoCpf; // testando?cpf=valor_invalido Route::get('testando', function (Request $request) { try{ $dados = $request->validate([ 'cpf' => ['required', new FormatoCpf] // outras validações aqui ]); } catch (\Illuminate\Validation\ValidationException $e) { dd($e->errors()); } }); ``` Changelog --------- [](#changelog) - 9.1.0 - Validação `cns` (cartão nacional de saúde) adicionada. - 8.0.3 - Validação `uf` adicionada. - 8.0.2 - Validação `cpf_ou_cnpj` - 5.2.1 - Validação `cpf_ou_cnpj` Sugestões --------- [](#sugestões) [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. Doações ------- [](#doações) [Paypal](https://www.paypal.com/donate/?business=KCAGBVD5TJLUL&no_recurring=0&item_name=Ajude+a+sustentar+algu%C3%A9m+que+apoia+o+open-source+%3A%29¤cy_code=BRL) ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community17 Small or concentrated contributor base Maturity73 Established project with proven stability Bus Factor1 Top contributor holds 73.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~135 days Recently: every ~189 days Total 22 Last Release 790d ago Major Versions 5.1.3 → 8.0.22021-01-28 5.2.1 → 8.0.32021-06-08 8.0.3 → 9.0.02022-02-15 9.1.0 → 10.0.02023-01-31 10.0.1 → 11.0.02024-03-13 ### Community Maintainers ![](https://www.gravatar.com/avatar/841a5eca768df321576fce493c9a8443d530bdd60d15f8bf603d689054e30f86?d=identicon)[Aluisio-Pires](/maintainers/Aluisio-Pires) --- Top Contributors [![wallacemaxters](https://avatars.githubusercontent.com/u/5245865?v=4)](https://github.com/wallacemaxters "wallacemaxters (84 commits)")[![Aluisio-Pires](https://avatars.githubusercontent.com/u/88967089?v=4)](https://github.com/Aluisio-Pires "Aluisio-Pires (6 commits)")[![insign](https://avatars.githubusercontent.com/u/1113045?v=4)](https://github.com/insign "insign (3 commits)")[![rodrigowbazevedo](https://avatars.githubusercontent.com/u/6214250?v=4)](https://github.com/rodrigowbazevedo "rodrigowbazevedo (3 commits)")[![devmarcelosantos](https://avatars.githubusercontent.com/u/23081234?v=4)](https://github.com/devmarcelosantos "devmarcelosantos (2 commits)")[![brcontainer](https://avatars.githubusercontent.com/u/4368952?v=4)](https://github.com/brcontainer "brcontainer (2 commits)")[![crispossa](https://avatars.githubusercontent.com/u/889255?v=4)](https://github.com/crispossa "crispossa (2 commits)")[![FabioPereiraBraga](https://avatars.githubusercontent.com/u/10922392?v=4)](https://github.com/FabioPereiraBraga "FabioPereiraBraga (1 commits)")[![abomfim](https://avatars.githubusercontent.com/u/205500?v=4)](https://github.com/abomfim "abomfim (1 commits)")[![jfbueno](https://avatars.githubusercontent.com/u/8502026?v=4)](https://github.com/jfbueno "jfbueno (1 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (1 commits)")[![leandroramos](https://avatars.githubusercontent.com/u/3253741?v=4)](https://github.com/leandroramos "leandroramos (1 commits)")[![LucasLm2](https://avatars.githubusercontent.com/u/28629407?v=4)](https://github.com/LucasLm2 "LucasLm2 (1 commits)")[![marcioelias](https://avatars.githubusercontent.com/u/2084051?v=4)](https://github.com/marcioelias "marcioelias (1 commits)")[![renan-s-oliveira](https://avatars.githubusercontent.com/u/15692416?v=4)](https://github.com/renan-s-oliveira "renan-s-oliveira (1 commits)")[![ricardobarantini](https://avatars.githubusercontent.com/u/1111361?v=4)](https://github.com/ricardobarantini "ricardobarantini (1 commits)")[![claudsonm](https://avatars.githubusercontent.com/u/4139808?v=4)](https://github.com/claudsonm "claudsonm (1 commits)")[![DouglasDiniz](https://avatars.githubusercontent.com/u/18072367?v=4)](https://github.com/DouglasDiniz "DouglasDiniz (1 commits)")[![Dylan-DPC](https://avatars.githubusercontent.com/u/99973273?v=4)](https://github.com/Dylan-DPC "Dylan-DPC (1 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/aluisio-pires-pt-br-validator/health.svg) ``` [![Health](https://phpackages.com/badges/aluisio-pires-pt-br-validator/health.svg)](https://phpackages.com/packages/aluisio-pires-pt-br-validator) ``` ### Alternatives [spatie/laravel-honeypot Preventing spam submitted through forms 1.6k6.0M60](/packages/spatie-laravel-honeypot)[proengsoft/laravel-jsvalidation Validate forms transparently with Javascript reusing your Laravel Validation Rules, Messages, and FormRequest 1.1k2.3M49](/packages/proengsoft-laravel-jsvalidation)[stevebauman/purify An HTML Purifier / Sanitizer for Laravel 5325.6M19](/packages/stevebauman-purify)[axlon/laravel-postal-code-validation Worldwide postal code validation for Laravel and Lumen 3853.3M1](/packages/axlon-laravel-postal-code-validation)[sunspikes/clamav-validator Custom Laravel 5 anti-virus validator for file uploads. 3651.8M3](/packages/sunspikes-clamav-validator)[laravel-validation-rules/credit-card Validate credit card number, expiration date, cvc 2412.2M5](/packages/laravel-validation-rules-credit-card) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)