PHPackages                             misterioso013/cpf - 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. misterioso013/cpf

ActiveLibrary[Validation & Sanitization](/categories/validation)

misterioso013/cpf
=================

Simples Gerador e Validador de CPF PHP

1.1.1(1y ago)41.4k1[6 PRs](https://github.com/misterioso013/cpf/pulls)MITPHPPHP >=8.1CI passing

Since Mar 22Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/misterioso013/cpf)[ Packagist](https://packagist.org/packages/misterioso013/cpf)[ Docs](https://github.com/misterioso013/cpf)[ RSS](/packages/misterioso013-cpf/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (3)Versions (9)Used By (0)

Gerador e validador de CPF 🇧🇷
=============================

[](#gerador-e-validador-de-cpf-)

[![CI Status](https://github.com/misterioso013/cpf/workflows/CI/badge.svg)](https://github.com/misterioso013/cpf/workflows/CI/badge.svg)[![Latest Stable Version](https://camo.githubusercontent.com/acd862f1fca3ab40fa2e62ff60b845268693dcdec775c22a7cb22f1976848ec1/68747470733a2f2f706f7365722e707567782e6f72672f6d6973746572696f736f3031332f6370662f76)](https://packagist.org/packages/misterioso013/cpf)[![License](https://camo.githubusercontent.com/60b4fde8a0cea82486b619fd7101d51b1bb3bb610502ee58706a892d7cc14b3e/68747470733a2f2f706f7365722e707567782e6f72672f6d6973746572696f736f3031332f6370662f6c6963656e7365)](https://packagist.org/packages/misterioso013/cpf)

Biblioteca PHP moderna para geração e validação de CPFs.

### Requisitos 📋

[](#requisitos-)

- PHP 8.1 ou superior
- Composer

Instalação 💿
------------

[](#instalação-)

```
composer require misterioso013/cpf
```

Uso 🚀
-----

[](#uso-)

### Usando Value Object (Recomendado)

[](#usando-value-object-recomendado)

```
use Misterioso013\Tools\ValueObjects\Cpf;

// Criar um CPF a partir de uma string
$cpf = new Cpf('12345678909');

// Formatar CPF
echo $cpf->format(); // 123.456.789-09

// Gerar CPF aleatório
$cpf = Cpf::generate(); // Com máscara por padrão
$cpf = Cpf::generate(false); // Sem máscara

// Gerar CPF para um estado específico
$cpf = Cpf::generate(true, 'SP');

// Verificar UF do CPF
echo $cpf->getUF(); // Retorna string (ex: "SP")
$ufs = $cpf->getUF(false); // Retorna array
```

### Usando API Legacy

[](#usando-api-legacy)

```
use Misterioso013\Tools\CPF;

// Gerar CPF válido formatado (123.456.789-10)
echo CPF::cpfRandom();

// Gerar CPF válido sem máscara (12345678910)
echo CPF::cpfRandom(false);

// Verificar se CPF é válido
var_dump(CPF::validateCPF('12345678910'));

// Verificar UF do CPF
print_r(CPF::whichUF('12345678910', false));
```

Testes 🧪
--------

[](#testes-)

```
composer test
```

Contribuindo 🤝
--------------

[](#contribuindo-)

Contribuições são bem-vindas! Por favor, leia as [diretrizes de contribuição](CONTRIBUTING.md) antes de enviar um PR.

Licença 📄
---------

[](#licença-)

Este projeto está licenciado sob a licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance71

Regular maintenance activity

Popularity20

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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

Every ~1087 days

Total

2

Last Release

425d ago

PHP version history (2 changes)1.0.0PHP >=7.0.0

1.1.1PHP >=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/4c14d2ae750abf7c03757a5011a138b39a034797a291ad5a02456a3e91184d73?d=identicon)[misterioso013](/maintainers/misterioso013)

---

Top Contributors

[![misterioso013](https://avatars.githubusercontent.com/u/25601845?v=4)](https://github.com/misterioso013 "misterioso013 (3 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (3 commits)")[![leonetecbr](https://avatars.githubusercontent.com/u/26193295?v=4)](https://github.com/leonetecbr "leonetecbr (1 commits)")

---

Tags

cpfcpf-generatorcpf-validadorphpcpfCFP GeneratorCPF Validate

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/misterioso013-cpf/health.svg)

```
[![Health](https://phpackages.com/badges/misterioso013-cpf/health.svg)](https://phpackages.com/packages/misterioso013-cpf)
```

###  Alternatives

[ashallendesign/laravel-config-validator

A package for validating your Laravel app's config.

217905.3k5](/packages/ashallendesign-laravel-config-validator)[crazybooot/base64-validation

Laravel validators for base64 encoded files

1341.9M8](/packages/crazybooot-base64-validation)[bissolli/validador-cpf-cnpj

Classe em PHP para validação de CPF e CNPJ.

2089.0k](/packages/bissolli-validador-cpf-cnpj)[yiibr/yii2-br-validator

Provide validations and features for brazilian localization

14103.2k4](/packages/yiibr-yii2-br-validator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)