PHPackages                             benauld345/uk-postcode-parser - 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. [Validation & Sanitization](/categories/validation)
4. /
5. benauld345/uk-postcode-parser

ActiveLibrary[Validation & Sanitization](/categories/validation)

benauld345/uk-postcode-parser
=============================

PHP utility for parsing and validating United Kingdom Postcodes

v0.1(8y ago)496.3k↑149.3%1MITPHPPHP >=7.0

Since Jan 4Pushed 3y ago1 watchersCompare

[ Source](https://github.com/benauld345/uk-postcode-parser)[ Packagist](https://packagist.org/packages/benauld345/uk-postcode-parser)[ RSS](/packages/benauld345-uk-postcode-parser/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (4)Used By (0)

UK Postcode Parser
==================

[](#uk-postcode-parser)

UK Postcode Parser is a simple PHP utility for validating and parsing a UK postcodes.

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

[](#installation)

This package can be installed using composer:

```
composer require benauld345/uk-postcode-parser

```

Usage
-----

[](#usage)

### Parser/Postcode object

[](#parserpostcode-object)

To create an instance of a postcode:

```
use Benauld345\UkPostcodeParser\Postcode;

$postcode = new Postcode('dn55 1pt');

var_dump($postcode->getOutwardCode()); // DN55
var_dump($postcode->getInwardCode()); // 1PT
var_dump($postcode->getArea()); // DN
var_dump($postcode->getDistrict()); // 55
var_dump($postcode->getSector()); // 1
var_dump($postcode->getUnit()); // PT
var_dump($postcode->getFormattedPostcode()); // DN55 1PT

```

### Validator object

[](#validator-object)

The Validator object is a static utility class with the following methods:

`check()`: This method is for checking if a postcode is valid. Excepts full postcodes only:

```
use Benauld345\UkPostcodeParser\Validator;

var_dump(Validator::check('dn55 1pt')); // true
var_dump(Validator::check('dn551pt')); // true
var_dump(Validator::check('DN55 1PT')); // true
var_dump(Validator::check('not valid')); // false
var_dump(Validator::check('dn55')); // false

```

`sanitize()`: This method is used to clean up any user input. Strips any non-alphanumeric characters and returns the cleaned version uppercased

```
use Benauld345\UkPostcodeParser\Validator;

var_dump(Validator::sanitize("dn55 1pt")); // DN551PT

```

Issues/Bug Reporting
--------------------

[](#issuesbug-reporting)

Please log any issues in [GitHub Issues](https://github.com/benauld345/uk-postcode-parser/issues)

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity36

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity50

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

Every ~0 days

Total

2

Last Release

3056d ago

### Community

Maintainers

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

---

Top Contributors

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

---

Tags

composervalidationpackagepostcode

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/benauld345-uk-postcode-parser/health.svg)

```
[![Health](https://phpackages.com/badges/benauld345-uk-postcode-parser/health.svg)](https://phpackages.com/packages/benauld345-uk-postcode-parser)
```

###  Alternatives

[bensampo/laravel-enum

Simple, extensible and powerful enumeration implementation for Laravel.

2.0k15.9M104](/packages/bensampo-laravel-enum)[deligoez/tckimlikno

Turkish Identification Number Verification & Validation Package for Laravel

2917.4k](/packages/deligoez-tckimlikno)[phpexperts/datatype-validator

An easy to use data type validator (both strict and fuzzy).

141.1M2](/packages/phpexperts-datatype-validator)[progsmile/request-validator

Simple PHP Request Validator

33113.3k1](/packages/progsmile-request-validator)[larapack/command-validation

Enable a method for Artisan Commands to validate the output of methods like `ask`.

133.8k](/packages/larapack-command-validation)

PHPackages © 2026

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