PHPackages bunches/postcode - 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. bunches/postcode ActiveLibrary[Utility & Helpers](/categories/utility) bunches/postcode ================ A PHP package for handling and formatting UK postcodes. 1.0.0(12mo ago)02.5k↓39.2%1[1 PRs](https://github.com/bunches/postcode/pulls)MITPHPPHP ^8.3CI failing Since May 20Pushed 12mo ago3 watchersCompare [ Source](https://github.com/bunches/postcode)[ Packagist](https://packagist.org/packages/bunches/postcode)[ Docs](https://github.com/bunches/postcode)[ RSS](/packages/bunches-postcode/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (4)Versions (2)Used By (0) [![Contributor Covenant](https://camo.githubusercontent.com/2757a9db291c5ceda172e31d4fa5f3c4048a6e6257ee0b7113f80de277074b91/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e7472696275746f72253230436f76656e616e742d76322e3025323061646f707465642d6666363962342e737667)](code-of-conduct.md) Postcode ======== [](#postcode) A library for handling and formatting UK postcodes. Getting Started --------------- [](#getting-started) PHP 8.2 or above and Composer is expected to be installed. ### Installing Composer [](#installing-composer) For instructions on how to install Composer visit [getcomposer.org](https://getcomposer.org/download/). ### Installing [](#installing) After cloning this repository, change into the newly created directory and run: ``` composer install ``` or if you have installed Composer locally in your current directory: ``` php composer.phar install ``` This will install all dependencies needed for the project. Henceforth, the rest of this README will assume `composer` is installed globally (ie. if you are using `composer.phar` you will need to use `composer.phar` instead of `composer` in your terminal / command-line). Running the Tests ----------------- [](#running-the-tests) ### Unit tests [](#unit-tests) Unit testing in this project is via [PHPUnit](https://phpunit.de/). All unit tests can be run by executing: ``` composer phpunit ``` #### Debugging [](#debugging) To have PHPUnit stop and report on the first failing test encountered, run: ``` composer phpunit:debug ``` Code formatting --------------- [](#code-formatting) A standard for code style can be important when working in teams, as it means that less time is spent by developers processing what they are reading (as everything will be consistent). Code formatting is automated via [PHP-CS-Fixer](https://github.com/FriendsOfPHP/PHP-CS-Fixer). PHP-CS-Fixer will not format line lengths which do form part of the PSR-2 coding standards so these will product warnings when checked by [PHP Code Sniffer](https://github.com/squizlabs/PHP_CodeSniffer). These can be run by executing: ``` composer phpcs ``` ### Running everything [](#running-everything) All of the tests can be run by executing: ``` composer test ``` ### Outdated dependencies [](#outdated-dependencies) Checking for outdated Composer dependencies can be performed by executing: ``` composer outdated ``` ### Validating Composer configuration [](#validating-composer-configuration) Checking that the [composer.json](composer.json) is valid can be performed by executing: ``` composer validate --no-check-publish ``` ### Running via GNU Make [](#running-via-gnu-make) If GNU [Make](https://www.gnu.org/software/make/) is installed, you can replace the above `composer` command prefixes with `make`. All of the tests can be run by executing: ``` make test ``` ### Running the tests on a Continuous Integration platform (eg. Github Actions) [](#running-the-tests-on-a-continuous-integration-platform-eg-github-actions) Specific output formats better suited to CI platforms are included as Composer scripts. To output unit test coverage in text and Clover XML format (which can be used for services such as [Coveralls](https://coveralls.io/)): ``` composer phpunit:ci ``` To output PHP-CS-Fixer (dry run) and PHPCS results in checkstyle format (which GitHub Actions will use to output a readable format): ``` composer phpcs:ci ``` #### Github Actions [](#github-actions) Look at the example in [.github/workflows/main.yml](.github/workflows/main.yml). Built With ---------- [](#built-with) - [PHP](https://secure.php.net/) - [Composer](https://getcomposer.org/) - [PHPUnit](https://phpunit.de/) - [PHP Code Sniffer](https://github.com/squizlabs/PHP_CodeSniffer) - [GNU Make](https://www.gnu.org/software/make/) License ------- [](#license) This project is licensed under the MIT License - see the [LICENCE.md](LICENCE.md) file for details. ### Health Score 36 — LowBetter than 82% of packages Maintenance50 Moderate activity, may be stable Popularity23 Limited adoption so far Community9 Small or concentrated contributor base Maturity51 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 363d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/add28ef6e6aa69ae94393ab9e7ef7c5e63ca77384c7c41cccca5a678c4c2b53e?d=identicon)[elliotjreed](/maintainers/elliotjreed) --- Top Contributors [![elliotjreed](https://avatars.githubusercontent.com/u/5665859?v=4)](https://github.com/elliotjreed "elliotjreed (3 commits)") --- Tags postcode ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/bunches-postcode/health.svg) ``` [![Health](https://phpackages.com/badges/bunches-postcode/health.svg)](https://phpackages.com/packages/bunches-postcode) ``` ### Alternatives [michaelb/lumen-make Lumen make adds more make commands to lumen for jobs, controllers, middleware, etc. 2119.6k](/packages/michaelb-lumen-make) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)