NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2460 most downloaded on Packagist
Geocoder Service Provider for Laravel
Latest stable
13.2.2
Last release 5 months ago
23 Jun 2026
Release timing varies
gaps range from 2 weeks to 1.1 years
Nearly every release is documented
notes for 59 of 59 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
61 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
🔐 untrack composer.lock, pin guzzlehttp/psr7, add CI audit gate by @mikebronner in https://github.com/geocoder-php/GeocoderLaravel/pull/212
Full Changelog: https://github.com/geocoder-php/GeocoderLaravel/compare/13.2.1...13.2.2
🐛 Leave null cache.serializable_classes untouched under Laravel 13 by @mikebronner in https://github.com/geocoder-php/GeocoderLaravel/pull/211
Full Changelog: https://github.com/geocoder-php/GeocoderLaravel/compare/13.2.0...13.2.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
✨ Auto-register Geocoder model classes for Laravel 13 cache serialization. by @mikebronner in #209
Laravel 13 introduced cache.serializable_classes as a security hardening measure, defaulting to false to block deserialization of arbitrary PHP objects from the cache. This silently broke caching for any Laravel 13 user — geocoder results round-trip as Collections of Address objects, which the hardened default refuses to deserialize.
This release makes Laravel 13 caching work seamlessly without requiring you to maintain an allow-list.
If you're on Laravel 13 and have deliberately set cache.serializable_classes to a strict allow-list (or []) for security reasons, this release will merge the Geocoder model classes into your list at boot. The merge preserves your existing entries — but it does expand the allow-list beyond what you set.
If you want to keep your allow-list strictly under your own control:
// config/geocoder.php
'cache' => [
// ...
'auto_register_serializable_classes' => false,
],When opted out, you have two coherent paths — see the README's Laravel 13 cache.serializable_classes section for the trade-offs.
Pure composer update. No required config changes, no API breakage, no migrations.
Laravel 11 / 12 users: this release is functionally inert for you — the new config key is a no-op on framework versions that don't use cache.serializable_classes.
`
Full Changelog: 13.1.1...13.2.0
🛡️ 13.2.0 — Laravel 13 cache compatibility
Compare
fix: 🐛 Self-heal cache when corrupted non-Collection value is detected. by @mikebronner in https://github.com/geocoder-php/GeocoderLaravel/pull/207
Full Changelog: https://github.com/geocoder-php/GeocoderLaravel/compare/13.1.0...13.1.1
🌍 Add fluent locale() method for localization with caching.
Full Changelog: https://github.com/geocoder-php/GeocoderLaravel/compare/13.0.0...13.1.0
Laravel 13.x Compatibility by @laravel-shift in https://github.com/geocoder-php/GeocoderLaravel/pull/205
Str::slug when building reverse geocoding cache key by @valentin-dufois in https://github.com/geocoder-php/GeocoderLaravel/pull/204Full Changelog: https://github.com/geocoder-php/GeocoderLaravel/compare/5.0.0...13.0.0
Laravel 12 compatibility. Thanks @laravel-shift!
Note: I haven't been able to run tests on this package as of late. Please report back if you notice issues. I thought it was important to get the update out so people aren't blocked, and will work on updating the tests over time.
Laravel 11 compatibility. Thanks @laravel-shift!
### Added - Laravel 10 compatibility.
dummy Google Maps API key that was used for testing.
Laravel 9 compatibility. Thanks @nabilelmahiri!
dependencies to accommodate up-to-date versions.
clearing of empty items from cache using cache store name.
previous changes back, so that when the dependencies do support PHP 8, this package will be ready.
temporary support for PHP 8 until the dependencies officially support it.
### Fixed - TravisCI configuration.
### Added - Laravel 8 compatibility.
getProvider() method to no longer be deprecated, and instead return the currently set provider, or if none set, the first configured provider.
getProvider() method to no longer be deprecated, and instead return the
currently set provider, or if none set, the first configured provider.functionality to not cache requests by using doNotCache().
doNotCache().region code in provided config file from "en-US" to "us".
Updated config and readme to correctly indicate cache is measured in seconds, rather than minutes.
Updated config and readme to correctly indicate cache is measured in seconds, rather than minutes.
### Added - Laravel 7 compatibility.
configuration setting for reader to use array-notation, to allow config caching. Thanks @tooblue !
reader to use array-notation, to allow config caching. Thanks @tooblue !logger instantiation to not add logger if it doesn't exist.
logger injection in chain provider.
### Added - Laravel 6.1 compatibility.
### Added - Laravel 6.0 compatibility.
initialization of geocoder adapter.
string helper methods to future-proof things, as they are deprecated, thanks @nmfzone for submitting that PR!
### Added - Laravel 5.8 compatibility.
->toJson() method when querying results.
->toJson() method when querying results.### Added - Laravel 5.7 compatibility.
service provider to register singleton and alias in register() method.
register() method.class-name resolution from Service container, allowing for dependency injection. Thanks @anam-hossain!
work-around for missing config_path() function in Lumen.
config_path() function in Lumen.optional dedicated cache store.
### Added - Laravel 5.6 compatibiltiy.
loading of GeoIP2 provider from within Chain provider.
environment variable configuration option in default config to set Google Maps Locale.
cache duration to work on 32-bit systems.
erroneous method getProvider() and marked it as deprecated.
getProvider() and marked it as deprecated.### Fixed - missing PSR-7 dependency.
typo which caused cache to be in-effective.
the geocoder all() method to be deprecated. Use get().
geocodeQuery() and reverseQuery() methods.all() method to be deprecated. Use get().calls to cache by replacing cache helper function with IOC instance of cache.
cache key generation to work with UTF8 characters (Japanese, for example). Thanks @nguyenhaiphan!
caching functionality for geocode() and reverse() methods.
geocode() and reverse() methods.cache-duration variable to geocoder config.additional docblock and use-statement cleanup. Thanks @Alexgmin!
docblock class references to \Geocoder\Model\AddressCollection.
\Geocoder\Model\AddressCollection.alias declaration to be Lumen-compatible.
unit test for reverse-geocoding.
Laravel 5.3 requirement back to Laravel 5.0, JUST IN CASE it was working for people. (Only Laravel 5.3 and up is officially supported.)
minimum Laravel requirement specification to 5.3 (it was previously already the case, but not enforced in composer.json).
egeloen/http-adapter to php-http/httplug is coming with the next release of geocoder-php.Hi all, this is a fairly big release, with lots of backwards-incompatible changes. Be sure to read the readme carefully if you are upgrading!
Hi all, this is a fairly big release, with lots of backwards-incompatible changes. Be sure to read the readme carefully if you are upgrading!
This is tagged as release candidate 1 to suss out any wrinkles before marking it stable. Please test and report back. I will am implementing this in live projects and will monitor functionality as well.
geocode() and other methods.Geocoder\Laravel\....->all(), ->get(),
or ->dump()) after the respective command.- Added: support for Laravel 5.1
[BC] the package is now compatible for Laravel 5
fix the way to "implode" provider's arguments from the config file
This release uses Geocoder 2.4.\* :)
This release uses Geocoder 2.4.* :)
Supports provider's arguments [BC break]
Only app/config/packages/toin0u/geocoder-laravel/config.php stucture is changed. And it's easy to upgrade your config file.
return array(
'provider' => 'Geocoder\Provider\GoogleMapsProvider',
'adapter' => 'Geocoder\HttpAdapter\CurlHttpAdapter'
);
return array(
'providers' => array(
'Geocoder\Provider\GoogleMapsProvider' => array('my-locale', 'my-region', $ssl = true),
'Geocoder\Provider\CloudMadeProvider' => array('my-api-key'),
'Geocoder\Provider\FreeGeoIpProvider' => null, // or array()
// ...
),
'adapter' => 'Geocoder\HttpAdapter\CurlHttpAdapter'
);
- use Geocoder 2.3.x - use config file - use singleton instead of share - improve tests
One column per quarter.