bjmoreira / validatorbr
validação de campos utilizados no Brasil
Requires
- illuminate/support: ~5|~6
Requires (Dev)
- mockery/mockery: ^1.1
- orchestra/testbench: ~3|~4
- phpunit/phpunit: ^8.0
- sempro/phpunit-pretty-print: ^1.0
This package is auto-updated.
Last update: 2024-04-22 05:48:00 UTC
README
Esta é uma biblioteca com algumas validações brasileiras.
Instalação
Navegue até a pasta do seu projeto, por exemplo:
cd /etc/www/projeto
E então execute:
composer require bjmoreira/validatorbr
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:
-
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
) -
cnpj
- Valida se o campo é um CNPJ válido. É possível gerar um CNPJ válido para seus testes utilizando o site geradorcnpj.com -
cpf
- Valida se o campo é um CPF válido. É possível gerar um CPF válido para seus testes utilizando o site geradordecpf.org -
data
- Valida se o campo é uma data no formatoDD/MM/YYYY
*. Por exemplo:31/12/1969
. -
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_cpf
- Valida se o campo tem uma máscara de CPF correta (999.999.999-99
). -
formato_cpf_cnpj
- Valida se o campo tem uma máscara de CPF ou CNPJ correta (999.999.999-99
ou999.999.999-99
). -
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
ou(99) 9999-9999
). -
formato_placa_de_veiculo
- Valida se o campo tem o formato válido de uma placa de veículo.
Testando
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
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 validatorbr::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:
validatorbr::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!' ]; }