PHPackages                             paradisesessions/cep - 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. [Utility & Helpers](/categories/utility)
4. /
5. paradisesessions/cep

ActiveLibrary[Utility & Helpers](/categories/utility)

paradisesessions/cep
====================

Simple zip code consult with ViaCEP.

1.1(2y ago)17MITPHPPHP ^8.1

Since Sep 14Pushed 2y ago2 watchersCompare

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

READMEChangelog (4)Dependencies (1)Versions (5)Used By (0)

 [![Paradise Sessions](.github/logo.png "Paradise Sessions")](.github/logo.png)
===============================================================================

[](#----)

 [Installation](#installation) | [Technologies](#technologies) | [Using](#using) | [Tests](#tests)

 [![Version](https://camo.githubusercontent.com/65de29e083a3022e548d8395c7ad6e333f4b91ad49493c34ddc9bf327b968ef5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e312d677265656e3f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/65de29e083a3022e548d8395c7ad6e333f4b91ad49493c34ddc9bf327b968ef5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e312d677265656e3f7374796c653d666f722d7468652d6261646765) [![PHP Version](https://camo.githubusercontent.com/ce6aa67e647e27c66a037e72dcc90d2e0f743caa74edc5a7fe6a728663ea2762/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302d7265643f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/ce6aa67e647e27c66a037e72dcc90d2e0f743caa74edc5a7fe6a728663ea2762/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302d7265643f7374796c653d666f722d7468652d6261646765) [![License](https://camo.githubusercontent.com/7b032738aeb4a8dd7ec78c4402e078ca8c196b0e528c117bbd78088c9a036988/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75653f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/7b032738aeb4a8dd7ec78c4402e078ca8c196b0e528c117bbd78088c9a036988/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75653f7374796c653d666f722d7468652d6261646765)

Project
-------

[](#project)

##### Simple class for zip code query in the [ViaCEP](https://viacep.com.br/) public API.

[](#simple-class-for-zip-code-query-in-the-viacep-public-api)

Classe simples para consulta de CEP na api publica do [ViaCEP](https://viacep.com.br/).

Installation
------------

[](#installation)

###### By [Composer](https://getcomposer.org/)

[](#by-composer)

Via [Composer](https://getcomposer.org/)

```
composer require paradisesessions/cep
```

Technologies
------------

[](#technologies)

- [PHP 8.1](https://www.php.net/downloads.php#v8.1.18)
- [Pest | PHP testing framework](https://pestphp.com/)

Using
-----

[](#using)

###### Example of use for a simple query.

[](#example-of-use-for-a-simple-query)

Exemplo de uso para uma simples consulta.

```
$cep = new \ParadiseSessions\Cep\Cep();
if (!$cep->consult('04538133')) {
    exit($cep->fail()->getMessage());
}

var_dump($cep->data());

echo "Address: {$cep->address} {$cep->complement}, {$cep->city} - {$cep->state}";
echo "Zip code: {$cep->format()}";
```

###### \*you can pass the formatted zip code and it will work.

[](#you-can-pass-the-formatted-zip-code-and-it-will-work)

Pode passar o CEP formatado que funcionará.

Tests
-----

[](#tests)

###### Test class with [Pest](https://pestphp.com/).

[](#test-class-with-pest)

Testes na classe realizados com [Pest](https://pestphp.com/).

```
composer test
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 85.7% 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

Every ~0 days

Total

4

Last Release

969d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f6b40bfdf390a38dc6c70791babc14ccf3d91ef2c31af70eeb11c8f32656df68?d=identicon)[paradisesessions](/maintainers/paradisesessions)

---

Top Contributors

[![iaematt](https://avatars.githubusercontent.com/u/18090574?v=4)](https://github.com/iaematt "iaematt (6 commits)")[![paradisesessions](https://avatars.githubusercontent.com/u/130807464?v=4)](https://github.com/paradisesessions "paradisesessions (1 commits)")

---

Tags

cepconsultaphpphp8viacepphpcepphp8viacep

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/paradisesessions-cep/health.svg)

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

###  Alternatives

[yaroslavche/bitmask

BitMask, EnumBitMask

3453.7k1](/packages/yaroslavche-bitmask)[flyingluscas/viacep-php

ViaCEP PHP SDK

3640.2k](/packages/flyingluscas-viacep-php)[jansenfelipe/cep-gratis

Com esse pacote você poderá realizar consultas de CEP gratuitamente.

689.4k](/packages/jansenfelipe-cep-gratis)[marcin-orlowski/lombok-php

Never write boilerplate code for your data class again!

3118.6k1](/packages/marcin-orlowski-lombok-php)[andreas-glaser/php-helpers

A comprehensive collection of PHP utility functions for array manipulation, string operations, date handling, HTML generation, form building, validation, and more. Modern PHP 8.2+ library with full type safety.

1386.5k2](/packages/andreas-glaser-php-helpers)[minime/brasil-endereco

Brasil/Endereco é um componente de consulta que facilita a obtenção de endereços a partir do site dos correios

153.1k](/packages/minime-brasil-endereco)

PHPackages © 2026

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