Laravel Postcodes: A Service Wrapper Around Postcodes.io

Laravel Postcodes is a package by Steve McDougall that provides a validation rule and macro for validating post codes. The package uses the postcodes.io service—a free and open-source API—for looking up geocoded UK postcodes.

There are three ways to interact with postcodes using this package. First, you can use the provided validation rule:

use JustSteveKing\LaravelPostcodes\Rules\Postcode;

$this->validate($request, [
    ‘postcode’ => [
        ‘required’,
        ‘string’,
        new Postcode()
    ]
]);

Second, you can use the provided macro:

$this->validate($request, [
    ‘postcode’ => [
        ‘required’,
        ‘string’,
        Rule::postcode()
    ]
]);

Third, this package defines a service for interacting with the API directly:

use JustSteveKing\LaravelPostcodes\Service\PostcodeService;

app(PostcodeService::class)->getPostcode($postcode);

You can learn more about this package, get full installation instructions, and view the source code on GitHub at JustSteveKing/LaravelPostcodes.

This package was submitted to our Laravel News Links section. This section is a place the community can post packages and tutorials around the Laravel ecosystem. Follow along on Twitter @LaravelLinks