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 laravellegends/pt-br-validator:5.1.* --no-scripts

Ou então adicione no arquivo composer.json, adicione no seu "require":, exemplo:

{
    "require": {
        "laravellegends/pt-br-validator": "5.1.*"
    }
}

Rode o comando composer update --no-scripts.

Após a instalação, adicione no arquivo config/app.php a seguinte linha:

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:

• celular - Valida se o campo está no formato (99999-9999 ou 9999-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 formato DD/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_cep - Valida se o campo tem uma máscara de correta (99999-999 ou 99.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 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());

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'])