PHPackages                             gabrielmoura/laravel-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. [Caching](/categories/caching)
4. /
5. gabrielmoura/laravel-cep

ActiveLibrary[Caching](/categories/caching)

gabrielmoura/laravel-cep
========================

A simple Laravel package to get CEP information

1.0(2y ago)21.9k↓50%1MITPHPPHP ^8.2

Since Dec 9Pushed 2y ago1 watchersCompare

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

READMEChangelogDependencies (4)Versions (2)Used By (0)

Laravel CEP: A Robust CEP Lookup Package
========================================

[](#laravel-cep-a-robust-cep-lookup-package)

A comprehensive Laravel package for fetching Brazilian zip code (CEP) information from multiple providers, offering seamless caching and flexibility.

Features
--------

[](#features)

- **Multiple Providers:** Integrates with:
    - [ViaCEP](https://viacep.com.br/)
    - [Postmon](https://postmon.com.br/)
    - [Open CEP](https://opencep.com/)
    - [Brasil API](https://brasilapi.com.br/)
- **Intelligent Caching:** Streamlines performance with optional Redis caching.
- **Ease of Use:** Simple interface via container or facade.
- **Customizable:** Configure the preferred provider.

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

[](#installation)

```
composer require gabrielmoura/laravel-cep
```

Configuration
-------------

[](#configuration)

Publish the configuration file (optional):

```
php artisan vendor:publish --provider="Gabrielmoura\LaravelCep\CepServiceProvider"
```

In your `config/services.php`, adjust the default provider if desired:

```
'cep' => [
   'endpoint' => \Gabrielmoura\LaravelCep\EndpointOption::POSTMON, // Example: Change to your preferred provider
],
```

**Strongly consider installing `illuminate/redis` for automatic caching.**

Usage
-----

[](#usage)

**Container:**

```
use Gabrielmoura\LaravelCep\CepService;
$cepData = app(CepService::class)->find('01001000', true); // Enable caching
```

**Facade:**

```
use Gabrielmoura\LaravelCep\Cep;
$cepData = Cep::find('01001000', true); // Enable caching
```

Compatibility
-------------

[](#compatibility)

- Laravel 10.x

Contributing
------------

[](#contributing)

We welcome contributions! Please refer to our [CONTRIBUTING.md](./CONTRIBUTING.md)

License
-------

[](#license)

Laravel CEP is released under the MIT License.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity54

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

885d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/37e17458fd2a5d749af1f2804f4250f2776d7eb5badfb5b157d3b4b71c546906?d=identicon)[gabrielmoura](/maintainers/gabrielmoura)

---

Top Contributors

[![gabrielmoura](https://avatars.githubusercontent.com/u/3229287?v=4)](https://github.com/gabrielmoura "gabrielmoura (15 commits)")

---

Tags

brasilapiceplaravelopenceppostmonredisviaceplaravelrediscep

###  Code Quality

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[awssat/laravel-visits

Laravel Redis visits counter for Eloquent models

975163.6k2](/packages/awssat-laravel-visits)[encore/redis-manager

Redis manager for laravel

25243.1k](/packages/encore-redis-manager)[vink/nova-cache-card

Manage your application's cache from a handy Laravel Nova dashboard card.

26317.3k1](/packages/vink-nova-cache-card)[moox/jobs

Manage Job Queues, Failed Jobs and Batches in Filament.

6421.8k](/packages/moox-jobs)[byerikas/cache-tags

Allows for Redis/Valkey cache flushing multiple tagged items by a single tag.

1413.9k](/packages/byerikas-cache-tags)[craftsys/laravel-redis-session-enhanced

Enhanced redis driver for sessions in Laravel

106.6k](/packages/craftsys-laravel-redis-session-enhanced)

PHPackages © 2026

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