PHPackages casilhero/brazilian-validators-laravel - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Validation & Sanitization](/categories/validation) 4. / 5. casilhero/brazilian-validators-laravel ActiveLibrary[Validation & Sanitization](/categories/validation) casilhero/brazilian-validators-laravel ====================================== Laravel bridge for casilhero/brazilian-validators. v1.0.0(1mo ago)0165↑81.3%MITPHPPHP ^8.1CI passing Since Apr 17Pushed 1mo agoCompare [ Source](https://github.com/Casilhero/brazilian-validators-laravel)[ Packagist](https://packagist.org/packages/casilhero/brazilian-validators-laravel)[ RSS](/packages/casilhero-brazilian-validators-laravel/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (6)Versions (2)Used By (0) casilhero/brazilian-validators-laravel ====================================== [](#casilherobrazilian-validators-laravel) Integração oficial com Laravel do pacote [casilhero/brazilian-validators](https://github.com/Casilhero/brazilian-validators). Fornece Rules prontas para `FormRequest`, mensagens de validação traduzíveis e uma Facade para uso programático. > Prefere sem dependência de framework? Use o [PHP puro](https://github.com/Casilhero/brazilian-validators). Precisa também no frontend? Veja a versão [JavaScript / TypeScript](https://github.com/Casilhero/brazilian-validators-javascript). Requisitos ---------- [](#requisitos) - PHP `^8.1` - Laravel `^12.0 || ^13.0` Instalação ---------- [](#instalação) ``` composer require casilhero/brazilian-validators-laravel ``` O Service Provider é registrado automaticamente via auto-discovery. Rules ----- [](#rules) Use as Rules diretamente no array `rules()` de um `FormRequest`: ``` use Casilhero\BrazilianValidatorsLaravel\Rules\Cnpj; use Casilhero\BrazilianValidatorsLaravel\Rules\Cpf; use Casilhero\BrazilianValidatorsLaravel\Rules\InscricaoEstadual; use Casilhero\BrazilianValidatorsLaravel\Rules\ProcessoJudicial; use Casilhero\BrazilianValidatorsLaravel\Rules\Renavam; use Illuminate\Foundation\Http\FormRequest; class StoreCustomerRequest extends FormRequest { public function rules(): array { return [ 'cpf' => ['required', 'string', new Cpf()], 'cnpj' => ['required', 'string', new Cnpj()], 'renavam' => ['required', 'string', new Renavam()], 'inscricao_estadual' => ['required', 'string', new InscricaoEstadual('SP')], 'processo_judicial' => ['required', 'string', new ProcessoJudicial()], ]; } } ``` ### Rules disponíveis [](#rules-disponíveis) CampoClasseObservaçãoCPF`Rules\Cpf`CNPJ`Rules\Cnpj`CPF ou CNPJ`Rules\CpfCnpj`SUFRAMA`Rules\Suframa`NIS/PIS`Rules\NisPis`Telefone BR`Rules\Phone`Telefone BR com DDI`Rules\PhoneDdi`CNH`Rules\Cnh`CNS`Rules\Cns`RENAVAM`Rules\Renavam`Título de Eleitor`Rules\TituloEleitor`Chassi (VIN)`Rules\Chassi`Inscrição Estadual`Rules\InscricaoEstadual`Recebe `string $uf` no construtor (ex.: `'SP'`)Certidão`Rules\Certidao`Aceita formato com ou sem espaços/hífensPassaporte`Rules\Passaporte`2 letras + 6 dígitos (ex.: `AB123456`)CAEPF`Rules\Caepf`Processo Judicial`Rules\ProcessoJudicial`Formato CNJ: `NNNNNNN-DD.AAAA.J.TR.OOOO`Boleto`Rules\Boleto`Aceita bancário (47 dígitos) e arrecadação (48 dígitos)Facade ------ [](#facade) A Facade `BrazilianValidator` é útil fora do contexto de Request, como em serviços, jobs ou artisan commands: ``` use Casilhero\BrazilianValidatorsLaravel\Facades\BrazilianValidator; // Retorno bool BrazilianValidator::cpf('529.982.247-25'); BrazilianValidator::cnpj('04.252.011/0001-10'); BrazilianValidator::phone('(11) 98765-4321'); BrazilianValidator::renavam('77077411168'); BrazilianValidator::chassi('9BWZZZ377VT004251'); BrazilianValidator::tituloEleitor('123456789012'); BrazilianValidator::inscricaoEstadual('110042490114', 'SP'); BrazilianValidator::certidao('10514 01 55 2024 1 00001 092 0000250-28'); BrazilianValidator::passaporte('AB123456'); BrazilianValidator::caepf('132.574.492/00-1'); BrazilianValidator::processoJudicial('0000001-41.2024.8.01.0001'); BrazilianValidator::boleto('34191.79001 01043.510047 91020.150008 2 85480000000000'); // Retorno ValidationResult (sufixo Result) $result = BrazilianValidator::cnpjResult('11.111.111/1111-11'); if (! $result->isValid()) { echo $result->code(); // ex: invalid_checksum } // Geração de dados de teste $cpf = BrazilianValidator::cpfGenerate(); $cnpj = BrazilianValidator::cnpjGenerate(); $phone = BrazilianValidator::phoneGenerate(); $cnh = BrazilianValidator::cnhGenerate(); $proc = BrazilianValidator::processoJudicialGenerate(); $boleto = BrazilianValidator::boletoGenerate(); // demais: cpfCnpjGenerate, suframaGenerate, nisPisGenerate, phoneDdiGenerate, // cnsGenerate, renavamGenerate, chassiGenerate, tituloEleitorGenerate, // certidaoGenerate, passaporteGenerate, caepfGenerate // Aplicação de máscara $maskedCpf = BrazilianValidator::cpfMask('52998224725'); // '529.982.247-25' $maskedCnpj = BrazilianValidator::cnpjMask('04252011000110'); // '04.252.011/0001-10' $maskedBoleto = BrazilianValidator::boletoMask('34191790010104351004791020150008285480000000000'); // '34191.79001 01043.510047 91020.150008 2 85480000000000' $maskedProc = BrazilianValidator::processoJudicialMask('00000014120248010001'); // '0000001-41.2024.8.01.0001' // demais: cpfCnpjMask, suframaMask, nisPisMask, phoneMask, phoneDdiMask, cnhMask, // renavamMask, chassiMask, tituloEleitorMask, certidaoMask, // passaporteMask, caepfMask // Parse (extrai campos estruturados) $certidaoInfo = BrazilianValidator::certidaoParse('10514 01 55 2024 1 00001 092 0000250-28'); $certidaoInfo?->codigoServentia; // '10514' $certidaoInfo?->descricaoLivro(); // 'Livro A (Nascimento)' $boletoInfo = BrazilianValidator::boletoParse('00190000090114971860168524522114675860000102656'); $boletoInfo?->type; // 'bancario' $boletoInfo?->bankCode; // '001' $boletoInfo?->amount; // 102656 $boletoInfo?->amountInReals(); // 1026.56 $boletoInfo?->expirationDate; // \DateTimeImmutable ``` Métodos `bool` disponíveis: `cpf`, `cnpj`, `cpfCnpj`, `suframa`, `nisPis`, `phone`, `phoneDdi`, `cnh`, `cns`, `renavam`, `chassi`, `tituloEleitor`, `inscricaoEstadual`, `certidao`, `passaporte`, `caepf`, `processoJudicial`, `boleto` — e suas variantes `*Result()` que retornam `ValidationResult`. > `inscricaoEstadual` e `inscricaoEstadualResult` recebem um segundo argumento `string $uf` (ex.: `'SP'`, `'RJ'`). Mensagens de validação ---------------------- [](#mensagens-de-validação) Os idiomas `pt_BR` e `en` estão inclusos no pacote. As mensagens seguem o namespace `brazilian-validators::validation.`. Para customizar as mensagens no seu projeto, publique os arquivos de idioma: ``` php artisan vendor:publish --tag=brazilian-validators-translations ``` Os arquivos serão publicados em: ``` lang/vendor/brazilian-validators/{locale}/validation.php ``` Compatibilidade --------------- [](#compatibilidade) ComponenteVersão suportadaPHP`^8.1` (inclui 8.2, 8.3, 8.4 e 8.5)Laravel`^12.0 || ^13.0`Core package`casilhero/brazilian-validators ^1.0`Testes ------ [](#testes) ``` composer test # executa a suíte Pest composer format # aplica Laravel Pint composer format:check # verifica formatação sem alterar arquivos ``` A CI valida o pacote em matriz com Laravel 12 e 13. Licença ------- [](#licença) MIT ### Health Score 40 — FairBetter than 86% of packages Maintenance89 Actively maintained with recent releases Popularity15 Limited adoption so far Community6 Small or concentrated contributor base Maturity42 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 54d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/5770e231eeadfeb91c75b0db69ae811b491d59b63181ebc12bb113c2f8dde787?d=identicon)[andrenunes01](/maintainers/andrenunes01) --- Top Contributors [![andrenunes01](https://avatars.githubusercontent.com/u/20850517?v=4)](https://github.com/andrenunes01 "andrenunes01 (1 commits)") --- Tags laravelvalidationbrazilcpfcnpj ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/casilhero-brazilian-validators-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/casilhero-brazilian-validators-laravel/health.svg)](https://phpackages.com/packages/casilhero-brazilian-validators-laravel) ``` ### Alternatives [propaganistas/laravel-phone Adds phone number functionality to Laravel based on Google's libphonenumber API. 3.0k38.3M138](/packages/propaganistas-laravel-phone)[psalm/plugin-laravel Psalm plugin for Laravel 3325.1M337](/packages/psalm-plugin-laravel)[bensampo/laravel-enum Simple, extensible and powerful enumeration implementation for Laravel. 2.0k16.6M107](/packages/bensampo-laravel-enum)[laravel/ai The official AI SDK for Laravel. 9782.1M153](/packages/laravel-ai)[proengsoft/laravel-jsvalidation Validate forms transparently with Javascript reusing your Laravel Validation Rules, Messages, and FormRequest 1.1k2.3M50](/packages/proengsoft-laravel-jsvalidation)[moonshine/moonshine Laravel administration panel 1.3k239.9k72](/packages/moonshine-moonshine) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)