PHPackages                             sirprize/postal-code-validator - 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. sirprize/postal-code-validator

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

sirprize/postal-code-validator
==============================

Validate Formatting Of World-Wide Postal Codes

1.5.1(2mo ago)791.9M↑21.6%25[3 issues](https://github.com/sirprize/postal-code-validator/issues)1MITPHPPHP ^7.2 || ^8.0CI failing

Since Mar 11Pushed 2mo ago5 watchersCompare

[ Source](https://github.com/sirprize/postal-code-validator)[ Packagist](https://packagist.org/packages/sirprize/postal-code-validator)[ Docs](https://github.com/sirprize/postal-code-validator)[ RSS](/packages/sirprize-postal-code-validator/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (20)Used By (1)

Postal-code-validator
=====================

[](#postal-code-validator)

Validate Formatting of World-Wide Postal Codes according this ["List of postal codes" article on Wikipedia](https://en.wikipedia.org/wiki/List_of_postal_codes)

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

[](#installation)

```
composer require sirprize/postal-code-validator

```

Usage
-----

[](#usage)

### Check If Country Is Supported

[](#check-if-country-is-supported)

```
use Sirprize\PostalCodeValidator\Validator;

$validator = new Validator();
$validator->hasCountry('CH'); // returns true

```

### Check If Postal Code Is Properly Formatted

[](#check-if-postal-code-is-properly-formatted)

```
use Sirprize\PostalCodeValidator\Validator;

$validator = new Validator();
$validator->isValid('CH', 'usjU87jsdf'); // returns false
$validator->isValid('CH', '3007'); // returns true

```

### Get The Possible Formats For a Specific Country

[](#get-the-possible-formats-for-a-specific-country)

```
use Sirprize\PostalCodeValidator\Validator;

$validator = new Validator();
$validator->getFormats('GB'); // returns ['@@## #@@', '@#@ #@@', '@@# #@@', '@@#@ #@@', '@## #@@', '@# #@@']

```

Formatting
----------

[](#formatting)

- `#` = `0-9`
- `@` = `a-zA-Z`

Country Codes
-------------

[](#country-codes)

Postal-code-validator uses [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 2-letter country codes

License
-------

[](#license)

See LICENSE.

###  Health Score

65

—

FairBetter than 99% of packages

Maintenance86

Actively maintained with recent releases

Popularity56

Moderate usage in the ecosystem

Community26

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor1

Top contributor holds 61.8% 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 ~223 days

Recently: every ~293 days

Total

19

Last Release

68d ago

PHP version history (3 changes)1.0.0PHP >=5.3.2

1.3.6PHP >=7.2

1.4.0PHP ^7.2 || ^8.0

### Community

Maintainers

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

---

Top Contributors

[![sirprize](https://avatars.githubusercontent.com/u/81617?v=4)](https://github.com/sirprize "sirprize (42 commits)")[![niektenhoopen](https://avatars.githubusercontent.com/u/3450011?v=4)](https://github.com/niektenhoopen "niektenhoopen (6 commits)")[![dmnc](https://avatars.githubusercontent.com/u/144790?v=4)](https://github.com/dmnc "dmnc (4 commits)")[![rogervila](https://avatars.githubusercontent.com/u/6053012?v=4)](https://github.com/rogervila "rogervila (3 commits)")[![xpavp03](https://avatars.githubusercontent.com/u/853656?v=4)](https://github.com/xpavp03 "xpavp03 (2 commits)")[![fogush](https://avatars.githubusercontent.com/u/2500435?v=4)](https://github.com/fogush "fogush (2 commits)")[![ickbinhier](https://avatars.githubusercontent.com/u/2810904?v=4)](https://github.com/ickbinhier "ickbinhier (2 commits)")[![landi029](https://avatars.githubusercontent.com/u/17082066?v=4)](https://github.com/landi029 "landi029 (1 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)")[![karolisg](https://avatars.githubusercontent.com/u/1695346?v=4)](https://github.com/karolisg "karolisg (1 commits)")[![rvelhote](https://avatars.githubusercontent.com/u/59101?v=4)](https://github.com/rvelhote "rvelhote (1 commits)")[![simonschaufi](https://avatars.githubusercontent.com/u/941794?v=4)](https://github.com/simonschaufi "simonschaufi (1 commits)")[![DrMerk](https://avatars.githubusercontent.com/u/121562885?v=4)](https://github.com/DrMerk "DrMerk (1 commits)")[![davidaniel](https://avatars.githubusercontent.com/u/1495114?v=4)](https://github.com/davidaniel "davidaniel (1 commits)")

---

Tags

validatorzip codepostal-code

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sirprize-postal-code-validator/health.svg)

```
[![Health](https://phpackages.com/badges/sirprize-postal-code-validator/health.svg)](https://phpackages.com/packages/sirprize-postal-code-validator)
```

###  Alternatives

[respect/validation

The most awesome validation engine ever created for PHP

5.9k37.4M383](/packages/respect-validation)[seld/jsonlint

JSON Linter

1.3k217.8M205](/packages/seld-jsonlint)[composer/spdx-licenses

SPDX licenses list and validation library.

1.4k184.2M25](/packages/composer-spdx-licenses)[barbieswimcrew/zip-code-validator

Constraint class for international zipcode validation

772.3M](/packages/barbieswimcrew-zip-code-validator)[axlon/laravel-postal-code-validation

Worldwide postal code validation for Laravel and Lumen

3853.3M1](/packages/axlon-laravel-postal-code-validation)[opis/json-schema

Json Schema Validator for PHP

64736.9M186](/packages/opis-json-schema)

PHPackages © 2026

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