README

Este pacote foi inspirado em outros dois pacotes, mas foi criado pela necessidade de uma customização melhor nas messages de validação e na validação dos formatos.

• geekcom - ValidatorDocs
• LaravelLegends - PtBrValidator

🔧 Instalação

Para fazer a instalação do pacote, rode o comando:

    composer require jp-system/validator-docs

📦 Customização

Nesse pacote você pode publicar as messages de validação e customizá-las, usando o comando:

    php artisan vendor:publish --tag="docs"

Caso não queira publicar o arquivo de tradução, você poderá criar suas próprias mensagens dentro do arquivo validation.php:

    'docs' => [
        'cpf' => 'Este campo deve ser um CPF válido.',
        ...
    ],

📋 Utilização

Todas as regras podem ser utilizadas a partir da Rule do próprio Laravel:

    'cpf' => [
        'required',
        'string',
        Rule::cpf(),
    ],
    'cnpj' => [
        'required',
        'string',
        Rule::cnpj()->format(),
    ],

As regras em que existe a opção de formatação, mas é opcional, podemos aplicar a formatação de três maneiras:

    'cpf' => [
        'required',
        'string',
        'cpf:format',
    ],
    'cnpj' => [
        'required',
        'string',
        Rule::cnpj()->format(),
    ],
    'cpf_or_cnpj' => [
        'required',
        'string',
        (new CPForCNPJ)->format(),
    ],

A regra para dinheiro aceita dois parâmetros, a moeda e a localicação. Utilizamos a classe de suporte Number do próprio Laravel:

    'money_1' => [
        'required',
        'string',
        'money:BRL,pt_BR', // default
    ],
    'money_2' => [
        'required',
        'string',
        Rule::money()->parameters(['USD', 'en_US']),
    ],

Caso você precise verificar o formato do dinheiro conforme alguma regra em específica, você pode setar os callbacks no seu AppServiceProvider:

    Money::setLocaleCallback(function ($default) {
        return Auth::user()?->locale ?? $default;
    });

    Money::setCurrencyCallback(function ($default) {
        return Auth::user()?->currency ?? $default;
    });

Qualquer melhoria ou correção, poderá abrir um PR ou Issue.

🚀 Obrigado!