PHPackages                             rickgoemans/dutch-province-postcode-helper - 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. rickgoemans/dutch-province-postcode-helper

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

rickgoemans/dutch-province-postcode-helper
==========================================

The helper package for dutch postcodes and province related stuff.

03PHPCI failing

Since Dec 15Pushed 1w ago1 watchersCompare

[ Source](https://github.com/rickgoemans/dutch-province-postcode-helper)[ Packagist](https://packagist.org/packages/rickgoemans/dutch-province-postcode-helper)[ RSS](/packages/rickgoemans-dutch-province-postcode-helper/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (3)Used By (0)

Dutch Province Postcode Helper
==============================

[](#dutch-province-postcode-helper)

This package helps you with common actions related to (Dutch) postcodes and provinces.
Source: [https://nl.wikipedia.org/wiki/Postcodes\_in\_Nederland](https://nl.wikipedia.org/wiki/Postcodes_in_Nederland)

Table of contents
-----------------

[](#table-of-contents)

[1.0 Install](#10-install)
[2.0 Usage](#20-usage)
[2.1 Get all provinces](#21-get-all-provinces)
[2.2 Get all postcode numbers](#22-get-all-postcode-numbers)
[2.3 Valid province](#23-valid-province)
[2.4 Valid postcode](#24-valid-postcode)
[2.5 Get province from postcode](#25-get-province-from-postcode)
[2.6 Check postcode in province](#26-check-postcode-in-province)
[3.0 Tests](#30-tests)
[4.0 Future expansions](#40-future-expansions)

1.0 Install
-----------

[](#10-install)

```
compose require rickgoemans/dutch-province-postcode-helper
```

2.0 Usage
---------

[](#20-usage)

Here are some examples of how to use this package.

### 2.1 Get all provinces

[](#21-get-all-provinces)

```
use DutchProvincePostcodeHelper\DutchProvincePostcodeHelper;

$provinces = (new DutchProvincePostcodeHelper())->getProvinces();
```

### 2.2 Get all postcode numbers

[](#22-get-all-postcode-numbers)

```
use DutchProvincePostcodeHelper\DutchProvincePostcodeHelper;

$provinces = (new DutchProvincePostcodeHelper())->getPostcodeNumbers();
```

### 2.3 Valid province

[](#23-valid-province)

```
use DutchProvincePostcodeHelper\DutchProvincePostcodeHelper;

if((new DutchProvincePostcodeHelper())->isValidProvince('Noord-Brabant')) {
    // valid
} else {
    // invalid
}
```

### 2.4 Valid postcode

[](#24-valid-postcode)

```
use DutchProvincePostcodeHelper\DutchProvincePostcodeHelper;

if((new DutchProvincePostcodeHelper())->isValidPostcode('5825 CP')) {
    // valid
} else {
    // invalid
}
```

### 2.5 Get province from postcode

[](#25-get-province-from-postcode)

```
use DutchProvincePostcodeHelper\DutchProvincePostcodeHelper;

try {
    $province = (new DutchProvincePostcodeHelper())->getProvinceFromPostcode('5825 CP'));
} catch (\DutchProvincePostcodeHelper\Exceptions\InvalidPostcode $e) {
    echo $e->getMessage();
}
```

### 2.6 Check postcode in province

[](#26-check-postcode-in-province)

```
use DutchProvincePostcodeHelper\DutchProvincePostcodeHelper;

try {
    if((new DutchProvincePostcodeHelper())isPostcodeInProvince('5825 CP', 'Noord-Brabant'))) {
        // true
    } else {
        // false
    }
} catch (\DutchProvincePostcodeHelper\Exceptions\InvalidPostcode $e) {
    echo $e->getMessage();
}
```

3.0 Tests
---------

[](#30-tests)

You can execute PHPUnit tests by running;

```
./vendor/bin/phpunit --bootstrap vendor/autoload.php tests/DutchProvincePostcodeHelperTest.php
```

4.0 Future expansions
---------------------

[](#40-future-expansions)

Nothing planned at the moment. Know of something useful to add? Post an issue!

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance64

Regular maintenance activity

Popularity3

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 80% 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://avatars.githubusercontent.com/u/7813679?v=4)[Rick Goemans](/maintainers/rickgoemans)[@rickgoemans](https://github.com/rickgoemans)

---

Top Contributors

[![rickgoemans](https://avatars.githubusercontent.com/u/7813679?v=4)](https://github.com/rickgoemans "rickgoemans (4 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

### Embed Badge

![Health badge](/badges/rickgoemans-dutch-province-postcode-helper/health.svg)

```
[![Health](https://phpackages.com/badges/rickgoemans-dutch-province-postcode-helper/health.svg)](https://phpackages.com/packages/rickgoemans-dutch-province-postcode-helper)
```

PHPackages © 2026

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