awcodes/postal-codes

This is a package to easily install and use postal codes in your Laravel application from GeoNames.org

v0.1.2 2025-10-22 14:10 UTC

Requires

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

Requires (Dev)

• laravel/pint: ^1.0
• spatie/laravel-ray: ^1.26

MIT

• awcodes

• laravel
• awcodes
• postal-codes

README

This is a package to easily install and use postal codes in your Laravel application. All data is provided by GeoNames data dumps. You can see the available countries at https://download.geonames.org/export/zip/.

Installation & Usage

You can install the package via composer:

composer require awcodes/postal-codes

If you need to publish the migration you may do so with:

php artisan postal-codes:install

Then the only thing left to do is to seed your data. This can be done with the postal-codes:seed command.

php artisan postal-codes:seed {country=US}

Changelog

Please see CHANGELOG for more information on 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.