PHPackages                             optiosteam/belgian-region-zip - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. optiosteam/belgian-region-zip

ActiveLibrary[Parsing & Serialization](/categories/parsing)

optiosteam/belgian-region-zip
=============================

PHP library for Belgian zip codes and cities per region/province

1.0.0(4y ago)480.0k—2.5%2MITPHPPHP >=7.2

Since Aug 27Pushed 4y ago3 watchersCompare

[ Source](https://github.com/optiosteam/belgian-region-zip)[ Packagist](https://packagist.org/packages/optiosteam/belgian-region-zip)[ RSS](/packages/optiosteam-belgian-region-zip/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

Belgian region zip codes
========================

[](#belgian-region-zip-codes)

The data in this library is based on the public data provided by **bpost** ().

Zip codes are ordered by region/province. For these regions the ISO 3166 code is used ()

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

[](#installation)

**Requirement**: PHP version >=7.2

```
composer require optiosteam/belgian-region-zip

```

Description
-----------

[](#description)

This library contains 1 main class `BelgianRegionZipHelper` with 3 static functions:

- `BelgianRegionZipHelper::getRegions()` returns all Belgian Regions/Provinces
- `BelgianRegionZipHelper::getZipCodesByRegionIsoCode(string $regionIsoCode)` returns all zip codes within a certain region/province
- `BelgianRegionZipHelper::getMunicipalitiesByZipCode(string $zipCode, ?string $regionIsoCode = null, ?string $languageCode = null)`returns all municipalities for a certain zip code. Optionally you can pass the region and the language. **NOTE**: bpost only provides translations of municipalities in Brussels, for other regions the Dutch and French name are the same.

For more information on the data structure, you can look at the json data in `src/Data`

Examples
--------

[](#examples)

### getMunicipalitiesByZipCode

[](#getmunicipalitiesbyzipcode)

```
echo '';
var_dump(BelgianRegionZipHelper::getMunicipalitiesByZipCode(1000));
echo '';
```

returns:

```
array(2) {
  'nl' =>
  array(1) {
    [0] =>
    string(7) "Brussel"
  }
  'fr' =>
  array(1) {
    [0] =>
    string(9) "Bruxelles"
  }
}

```

---

```
echo '';
var_dump(BelgianRegionZipHelper::getMunicipalitiesByZipCode(8000, 'BE-Vwv', 'nl'));
echo '';
```

returns:

```
array(2) {
  [0] =>
  string(6) "Brugge"
  [1] =>
  string(9) "Koolkerke"
}

```

### getZipCodesByRegionIsoCode

[](#getzipcodesbyregionisocode)

```
echo '';
var_dump(BelgianRegionZipHelper::getZipCodesByRegionIsoCode('BE-BRU'));
echo '';
```

returns:

```
array(22) {
  [0] =>
  int(1000)
  [1] =>
  int(1020)
  [2] =>
  int(1030)
  [3] =>
  int(1040)
  [4] =>
  int(1050)
  [5] =>
  int(1060)
  [6] =>
  int(1070)
  [7] =>
  int(1080)
  [8] =>
  int(1081)
  [9] =>
  int(1082)
  [10] =>
  int(1083)
  [11] =>
  int(1090)
  [12] =>
  int(1120)
  [13] =>
  int(1130)
  [14] =>
  int(1140)
  [15] =>
  int(1150)
  [16] =>
  int(1160)
  [17] =>
  int(1170)
  [18] =>
  int(1180)
  [19] =>
  int(1190)
  [20] =>
  int(1200)
  [21] =>
  int(1210)
}

```

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

[](#contributing)

Feel free to submit pull requests for improvements & bug fixes.

MIT License

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity35

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity45

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

1725d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/814d404abddc2aabda999e023c114eca619f439e5a69366c4bd9b5cb837e9e10?d=identicon)[simonwestyn](/maintainers/simonwestyn)

---

Top Contributors

[![simonwestyn](https://avatars.githubusercontent.com/u/21172932?v=4)](https://github.com/simonwestyn "simonwestyn (2 commits)")

---

Tags

belgiumbpostcomposer-packagejsonphppostal-codesprovinceszip-codesphpjsonregionprovinceBelgian zip codesBelgian postal codes

### Embed Badge

![Health badge](/badges/optiosteam-belgian-region-zip/health.svg)

```
[![Health](https://phpackages.com/badges/optiosteam-belgian-region-zip/health.svg)](https://phpackages.com/packages/optiosteam-belgian-region-zip)
```

###  Alternatives

[adhocore/json-fixer

Fix/repair truncated JSON data

51543.2k2](/packages/adhocore-json-fixer)[sbsaga/toon

🧠 TOON for Laravel — a compact, human-readable, and token-efficient data format for AI prompts & LLM contexts. Perfect for ChatGPT, Gemini, Claude, Mistral, and OpenAI integrations (JSON ⇄ TOON).

6115.6k](/packages/sbsaga-toon)[blancks/fast-jsonpatch-php

Class designed to efficiently handle JSON Patch operations in accordance with the RFC 6902 specification

396.4k](/packages/blancks-fast-jsonpatch-php)[josantonius/json

PHP simple library for managing Json files.

1621.6k10](/packages/josantonius-json)

PHPackages © 2026

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