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)485.3k↓49.8%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 4d 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 66% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity36

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity46

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

1773d 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

51589.4k2](/packages/adhocore-json-fixer)[m1/vars

Vars is a simple to use and easily extendable configuration loader with in built loaders for ini, json, PHP, toml, XML and yaml/yml file types. It also comes with in built support for Silex and more frameworks to come soon.

64124.3k1](/packages/m1-vars)[blancks/fast-jsonpatch-php

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

398.7k](/packages/blancks-fast-jsonpatch-php)[juststeveking/resume-php

A PHP library for building and working with the JSON resume schema.

1061.1k](/packages/juststeveking-resume-php)[josantonius/json

PHP simple library for managing Json files.

1822.8k10](/packages/josantonius-json)

PHPackages © 2026

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