PHPackages                             rauwebieten/zipcodes - 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. rauwebieten/zipcodes

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

rauwebieten/zipcodes
====================

Benelux zipcodes

1.5(5y ago)012PHPPHP ^7.3

Since Mar 13Pushed 5y ago1 watchersCompare

[ Source](https://github.com/rauwebieten/zipcodes)[ Packagist](https://packagist.org/packages/rauwebieten/zipcodes)[ RSS](/packages/rauwebieten-zipcodes/feed)WikiDiscussions master Synced 1w ago

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

[![Travis build status](https://camo.githubusercontent.com/a8490adcaeeab916054bbed853bffd64142283b8c80a17d308f28fb17d36c0d6/68747470733a2f2f7472617669732d63692e6f72672f726175776562696574656e2f7a6970636f6465732e7376673f6272616e63683d6d6173746572)](https://camo.githubusercontent.com/a8490adcaeeab916054bbed853bffd64142283b8c80a17d308f28fb17d36c0d6/68747470733a2f2f7472617669732d63692e6f72672f726175776562696574656e2f7a6970636f6465732e7376673f6272616e63683d6d6173746572)[![Maintainability](https://camo.githubusercontent.com/d4f7adc96ae63fd42c7363c831f313549e1445358f06941ca1aba3ae255c6379/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f34396565333532303139303834323739616364662f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/rauwebieten/zipcodes/maintainability)[![StyleCI](https://camo.githubusercontent.com/32ffeca9f903008ca9703008841728fb97988704f51548f848d14433f1e768e8/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3334373436383935312f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/347468951?branch=master)

Zipcodes
========

[](#zipcodes)

A collection of country zipcodes (postal codes).

Currently supported:

- BE
- DE
- ES
- FR
- IT
- LU
- NL

All data is fetched from geonames.org and converted to PHP array files.

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

[](#installation)

install library

```
composer require rauwebieten/zipcodes

```

Usage
-----

[](#usage)

Get all zipcodes for a country (use the country's ISO code as parameter)

```
$data = \RauweBieten\ZipCodes\ZipCodes::getData('BE');

```

You'll receive an array of zipcode entries:

```
[
    [
            "country" => "DE"
            "zipcode" => "01945"
            "place" => "Schwarzbach"
            "latitude" => "51.45"
            "longitude" => "13.9333"
    ],
    ...
]

```

Use this data to populate your database.
Do not use directly :)

Contribute
----------

[](#contribute)

Need some country zipcodes not supported yet?

1. Leave a github issue
2. or do pull request and use the builder like this, and follow the CLI instructions

    ```
     "bin/zipcodes"

    ```

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

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

5

Last Release

1892d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/59acbf4a62b72eba36a902011e336653854d735158432c0c3b382d95b4236589?d=identicon)[rauwebieten](/maintainers/rauwebieten)

---

Top Contributors

[![peter-kinamo](https://avatars.githubusercontent.com/u/20679429?v=4)](https://github.com/peter-kinamo "peter-kinamo (11 commits)")[![rauwebieten](https://avatars.githubusercontent.com/u/11740475?v=4)](https://github.com/rauwebieten "rauwebieten (4 commits)")

---

Tags

phppostal-codeszipcodes

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/rauwebieten-zipcodes/health.svg)

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

###  Alternatives

[cebe/yii2-gravatar

Gravatar Widget for Yii 2

441.8M35](/packages/cebe-yii2-gravatar)

PHPackages © 2026

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