Download the PHP package divineomega/php-postcodes without Composer
On this page you can find all versions of the php package divineomega/php-postcodes. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download divineomega/php-postcodes
More information about divineomega/php-postcodes
Files in divineomega/php-postcodes
Package php-postcodes
Short Description This library handles various UK postcode related tasks such as address lookup by postcode, postcode validation, generation of valid UK postcodes and getting a postcode's outward and inward codes.
License LGPL-3.0-only
Homepage https://github.com/divineomega/php-postcodes
Informations about the package php-postcodes
PHP Postcodes
This library handles various UK postcode related tasks.
Features
- Address lookup by postcode
- Postcode validation
- Generate valid UK postcodes
- Get a postcode's outward and inward codes
Installation
To install, just run the following composer command.
composer require divineomega/php-postcodes
Setup
Postcode Lookup Services
Using some of the data retrieval features provided by this library requires a postcode lookup service. It currently supports the following postcode lookup services.
- Ideal Postcodes - https://ideal-postcodes.co.uk
- Postcode Anywhere (PCA Predict) - https://www.pcapredict.com/
- Postcodes.io - http://postcodes.io/
Sign up at the respective website if you need to use these features.
You can then use the following code to get an appropriate postcode lookup service object.
Usage
Get addresses by postcode
To retrieve the addresses associated with a UK postcode, just pass it to the method shown below. You will receive an array of address objects, appropriately split by their address lines and other details.
Validate postcode
You can validate a UK postcode is correct using the Validator
utility class. An example of
how to do so is shown below.
Please note that the postcode validation is case insensitive.
Generate postcode
This library allows you generate a random, valid UK postcode. This makes use of the
Generator
utility class, as shown below.
Get outward and inward codes
The first part of the Postcode eg PO1 is called the outward code as it identifies the town or district to which the letter is to be sent for further sorting. The second part of the postcode eg 1EB is called the inward code.
All versions of php-postcodes with dependencies
guzzlehttp/guzzle Version ^6.0||^7.0
fakerphp/faker Version ^1.9.1
ext-json Version *