- Notifications
You must be signed in to change notification settings - Fork103
Uma biblioteca contendo validações de formatos Brasileiros, para o Laravel
License
LaravelLegends/pt-br-validator
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Esta biblioteca adiciona validações brasileira ao Laravel, como CPF, CNPJ, Placa de Carro, CEP, Telefone, Celular e afins.
🇧🇷🇧🇷🇧🇷
| Laravel | Biblioteca |
|---|---|
| 4.* | 4.* |
| 5.* | 5.1.* |
| ^6.0 || ^7.0 || ^8.0 | ^8.0 |
| ^9.0 | ^9.0 |
| ^10.0 | ^10.0 |
| ^11.0 | ^11.0 |
| ^12.0 | ^12.0 |
Navegue até a pasta do seu projeto, por exemplo:
cd /etc/www/projetoE então execute:
composer require laravellegends/pt-br-validatorCaso esteja utilizando uma versão desta biblioteca anterior a5.2, você deve o provider emconfig/app.php
'providers' => [// ... outros pacotesLaravelLegends\PtBrValidator\ValidatorProvider::class]
Agora, para utilizar a validação, basta fazer o procedimento padrão doLaravel.
A diferença é que será possível usar os seguintes métodos de validação:
| REGRA | Descrição |
|---|---|
| Celular | Valida se o campo está no formato (99999-9999 ou9999-9999) |
| 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) |
| celular_com_codigo | Valida se o campo está no formato+99(99)99999-9999 ou +99(99)9999-9999. |
| cnpj | Valida se o campo é um CNPJ válido. É possível gerar um CNPJ válido para seus testes utilizando o sitegeradorcnpj.com |
| cpf | Valida se o campo é um CPF válido. É possível gerar um CPF válido para seus testes utilizando o sitegeradordecpf.org |
| cns | Valida se o campo é um CNS válido. Use o sitegeradornv.com.br para testar |
| formato_cnpj | Valida se o campo tem uma máscara de CNPJ correta (99.999.999/9999-99). |
| formato_cpf | Valida se o campo tem uma máscara de CPF correta (999.999.999-99). |
| formato_cep | Valida se o campo tem uma máscara de correta (99999-999 ou99.999-999). |
| telefone | Valida se o campo tem umas máscara de telefone (9999-9999). |
| telefone_com_ddd | Valida se o campo tem umas máscara de telefone com DDD ((99)9999-9999). |
| telefone_com_codigo | Valida se o campo tem umas máscara de telefone com DDD (+55(99)9999-9999). |
| formato_placa_de_veiculo | Valida se o campo tem o formato válido de uma placa de veículo (incluindo o padrão MERCOSUL). |
| formato_pis | Valida se o campo tem o formato de PIS. |
| pis | Valida se o PIS é válido. |
| cpf_ou_cnpj | Valida se o campo é um CPF ou CNPJ |
| formato_cpf_ou_cnpj | Valida se o campo contém um formato de CPF ou CNPJ |
| uf | Valida se o campo contém uma sigla de Estado válido (UF) |
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 deIlluminate\Http\Request, através do métodovalidate.
Veja:
useIlluminate\Http\Request;// URL: /testando?telefone=3455-1222Route::get('testando',function (Request$request) {try{$dados =$request->validate(['telefone' =>'required|telefone',// outras validações aqui ]); }catch (\Illuminate\Validation\ValidationException$e) {dd($e->errors()); }});
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 deValidator::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étodomessages do seu Request criado pelo comandophp artisan make:request.
publicfunctionmessages() {return ['campo.telefone' =>'Telefone não válido!' ];}
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::classPor exemplo, se você deseja validar o formato do campo de um CPF, você pode utilizar a classeLaravelLegends\PtBrValidator\Rules\FormatoCpf da seguinte forma:
useIlluminate\Http\Request;useLaravelLegends\PtBrValidator\Rules\FormatoCpf;// testando?cpf=valor_invalidoRoute::get('testando',function (Request$request) {try{$dados =$request->validate(['cpf' => ['required',newFormatoCpf]// outras validações aqui ]); }catch (\Illuminate\Validation\ValidationException$e) {dd($e->errors()); }});
- 9.1.0 - Validação
cns(cartão nacional de saúde) adicionada. - 8.0.3 - Validação
ufadicionada. - 8.0.2 - Validação
cpf_ou_cnpj - 5.2.1 - Validação
cpf_ou_cnpj
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.
About
Uma biblioteca contendo validações de formatos Brasileiros, para o Laravel