toin0u/geocoder-laravel

Fixed

• 🔐 untrack composer.lock, pin guzzlehttp/psr7, add CI audit gate by @mikebronner in #212

Full Changelog: 13.2.1...13.2.2

Fixed

• 🐛 Leave null cache.serializable_classes untouched under Laravel 13 by @mikebronner in #211

Full Changelog: 13.2.0...13.2.1

Added

• ✨ 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.

⚠️ Behavior change worth noting

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.

🔧 Upgrade

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

Fixed

• fix: 🐛 Self-heal cache when corrupted non-Collection value is detected. by @mikebronner in #207

Full Changelog: 13.1.0...13.1.1

Added

• 🌍 Add fluent locale() method for localization with caching.
• 🔧 Resolve container-bound providers instead of via reflection.
• 🔧 Allow adapter configuration via config file.

Full Changelog: 13.0.0...13.1.0

Added

• Laravel 13.x Compatibility by @laravel-shift in #205
• Use service container to instantiate adapter by @JaZo in #191
• Remove use of Str::slug when building reverse geocoding cache key by @valentin-dufois in #204

New Contributors

• @valentin-dufois made their first contribution in #204

Full Changelog: 5.0.0...13.0.0

Removed

• dummy Google Maps API key that was used for testing.

Fixed

• non-caching declaration to only apply to current query.
• caching to take provider into account.

Changed

• getProvider() method to no longer be deprecated, and instead return the currently set provider, or if none set, the first configured provider.

Added

• functionality to not cache requests by using doNotCache().

Added

• Laravel 7 compatibility.

Fixed

• initialization of geocoder adapter.

Added

• ->toJson() method when querying results.

Changed

• service provider to register singleton and alias in register() method.

Added

• class-name resolution from Service container, allowing for dependency injection.

Added

• work-around for missing config_path() function in Lumen.

Added

• optional dedicated cache store.
• hashed cache keys and hash collision prevention.
• custom cache store configuration instructions.

Added

• Laravel 5.6 compatibility.

Fixed

• loading of GeoIP2 provider from within Chain provider.

Changed

• unit testing to use Orchstral Testbench.

Added

• environment variable configuration option in default config to set Google Maps Locale.
• documentation comments in configuration file.

Changed

• composer dependency version constraints for Laravel to be within a specific range, instead of open-ended.

Fixed

• cache duration to work on 32-bit systems.
• geocoder to not cache if no results are provided.

Fixed

• erroneous method getProvider() and marked it as deprecated.

Fixed

• missing PSR-7 dependency.

Added

• Laravel 5.5 package auto-discovery.

Fixed

• typo which caused cache to be in-effective.

Changed

• implemented geocoder-php 4.0.0.
• version to 4.0.0 instead of 2.0.0 to maintain major version parity with parent package.
• composer dependencies to release versions.
• unit tests to pass.
• updated readme with some clarifying notes. May have to completely rewrite it if it ends up being unclear.

Added

• caching functionality for geocode() and reverse() methods.
• cache-duration variable to geocoder config.

Added

• unit test for reverse-geocoding.

Removed

• minimum Laravel requirement of 5.3 (reverted back to 5.0, just in case it was working for someone, but only Laravel 5.3 and 5.4 are officially supported).

Changed

• minimum Laravel requirement to 5.3.

Added

• ability to dump results #16.
• ability to use multiple providers in addition to the chain provider #47.
• more integration tests.
• special aggregator that allows chaining of geocode() and other methods.

Changed

• README documentation.
• to use Geocoder 3.3.x.
• namespace to Geocoder\Laravel\....
• service provider to auto-load the facade.
• config file format.
• geocoding commands necessary to obtain results (must use ->all(), ->get(), or ->dump()) after the respective command.
• the service provider architecture.

Fixed

• MaxMindBinary Provider being instantiated with an Adapter #24.
• GeoIP2 Provider being instantiated with a generic Adapter.

Added

• code of conduct message.
• Laravel 5 compatibility [BC].

Updated

• documentation.

Fixed

• the way to implode provider's arguments + unit tests.

Updated

• to use Geocoder 2.4.x.

Added

• support for Provider arguments (backwards-compatibility break).

Added

• config file.

Updated

• to use Geocoder 2.3.x.
• to use singleton instead of share.
• tests.