awcodes / postal-codes

v1.0.2 2026-09-09 17:58 UTC

Requires

• php: ^8.3
• ext-zip: *
• maatwebsite/excel: ^4.0
• spatie/laravel-package-tools: ^1.14.0

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.0
• nunomaduro/collision: ^8.0
• orchestra/testbench: ^10.0|^11.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• rector/rector: ^2.0
• spatie/laravel-ray: ^1.26

MIT

• awcodes

• laravel
• awcodes
• postal-codes

Published on Packagist.org on 2026-09-09 18:44 UTC

README

Install a queryable table of postal codes in a Laravel application, seeded from GeoNames country data.

Documentation

The full documentation lives at docs.aw.codes/postal-codes.

Requirements

• PHP 8.3 or higher
• Laravel 12 or higher
• The zip PHP extension

Installation

composer require awcodes/postal-codes

The table is empty until you seed a country's data with php artisan postal-codes:seed. See Usage for that step.

Changelog

Please see the releases for what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• awcodes
• All Contributors

License

The MIT License (MIT). Please see License File for more information.