Code Monkey home page Code Monkey logo

pt-br-validator's Introduction

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

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

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:

REGRA Descrição
celular Valida se o campo está no formato (99999-9999 ou 9999-9999)
celular_sem_mascara Valida se o campo está no formato (999999999 ou 99999999)
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_ddd_sem_mascara Valida se o campo está no formato (99999999999 ou 9999999999)
celular_com_codigo Valida se o campo está no formato +99(99)99999-9999 ou +99(99)9999-9999.
celular_com_codigo_sem_mascara Valida se o campo está no formato +9999999999999 ou +999999999999.
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
cns Valida se o campo é um CNS válido. Use o site geradornv.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 ou 99.999-999).
telefone Valida se o campo tem umas máscara de telefone (9999-9999).
telefone_sem_mascara Valida se o campo é um telefone sem máscara (99999999).
telefone_com_ddd Valida se o campo tem umas máscara de telefone com DDD ((99)9999-9999).
telefone_com_ddd_sem_mascara Valida se o campo é um telefone com DDD sem máscara (9999999999).
telefone_com_codigo Valida se o campo tem umas máscara de telefone com DDD (+55(99)9999-9999).
telefone_com_codigo_sem_mascara Valida se o campo é um telefone com código e DDD sem máscara (+559999999999).
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)

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

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

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

  • 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

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

Paypal

pt-br-validator's People

Contributors

wallacemaxters avatar insign avatar rodrigowbazevedo avatar crispossa avatar brcontainer avatar devmarcelosantos avatar claudsonm avatar douglasdiniz avatar dylan-dpc avatar fabiopereirabraga avatar jfbueno avatar leandroembu avatar lucaslm2 avatar marcioelias avatar mayconpaivac avatar renan-s-oliveira avatar ricardobarantini avatar laravel-shift avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.