PHPackages                             luismarcelino/postal-pt - 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. luismarcelino/postal-pt

ActiveLaravel-library[Utility & Helpers](/categories/utility)

luismarcelino/postal-pt
=======================

Postal-PT is a bundle for Laravel with all Portuguese postal codes.

111PHP

Since Aug 18Pushed 10y ago2 watchersCompare

[ Source](https://github.com/luismarcelino/postal-pt)[ Packagist](https://packagist.org/packages/luismarcelino/postal-pt)[ RSS](/packages/luismarcelino-postal-pt/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Freguesias
==========

[](#freguesias)

Postal-PT is a Laravel 5 package that provides all post codes in Portugal.

Instalation
-----------

[](#instalation)

Add `luismarcelino/postal-pt` to `composer.json`.

```
"luismarcelino/postal-pt": "dev-master"

```

Run `composer update` to pull down the latest version of Postal Codes List.

Edit `config/app.php` and add the `provider` and `filter`

```
'providers' => [
    Luismarcelino\PostalPt\CodigosPostaisServiceProvider::class,
]

```

Now add the alias.

```
'aliases' => [
    'PostalPt' => Luismarcelino\PostalPt\CodigosPostaisFacade::class,
]

```

Publishing
----------

[](#publishing)

Optionaly you can publishing the configuration if you want to change the default table name `post_codes_pt`:

```
$ php artisan vendor:publish

```

To generate the migration file use:

```
$ php artisan postalpt:migration

```

This will generate the `_setup_post_codes_pt_table.php` migration file. To run the migration, run as usual:

```
php artisan migrate

```

As the amount of the data to be inserted in the 'post\_code\_pt' table is large, you must use the follow artisan command (there is no 'db:seed' file):

```
php artisan postalpt:seed

```

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

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.

### Community

Maintainers

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

---

Top Contributors

[![luismarcelino](https://avatars.githubusercontent.com/u/710735?v=4)](https://github.com/luismarcelino "luismarcelino (10 commits)")

### Embed Badge

![Health badge](/badges/luismarcelino-postal-pt/health.svg)

```
[![Health](https://phpackages.com/badges/luismarcelino-postal-pt/health.svg)](https://phpackages.com/packages/luismarcelino-postal-pt)
```

###  Alternatives

[bear/ace

Ace online editor utility

104.0k1](/packages/bear-ace)

PHPackages © 2026

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