Geocoder Laravel Laravel Package

Added

• ✨ Auto-register Geocoder model classes for Laravel 13 cache serialization. by @mikebronner in https://github.com/geocoder-php/GeocoderLaravel/pull/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: https://github.com/geocoder-php/GeocoderLaravel/compare/13.1.1...13.2.0

Fixed

• 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

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: https://github.com/geocoder-php/GeocoderLaravel/compare/13.0.0...13.1.0

Added

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

New Contributors

• @valentin-dufois made their first contribution in https://github.com/geocoder-php/GeocoderLaravel/pull/204

Full Changelog: https://github.com/geocoder-php/GeocoderLaravel/compare/5.0.0...13.0.0

Added

• Laravel 12 compatibility. Thanks @laravel-shift!
• GeoCoder 5 compatibility.

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.

Added

• Laravel 11 compatibility. Thanks @laravel-shift!

Added

• Laravel 10 compatibility.

Removed

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

Added

• Laravel 9 compatibility. Thanks @nabilelmahiri!

Changed

• dependencies to accommodate up-to-date versions.

Added

• clearing of empty items from cache using cache store name.

Added

• explicit PHP 8 support.

Reverted

• previous changes back, so that when the dependencies do support PHP 8, this package will be ready.

WIP

Adding

• temporary support for PHP 8 until the dependencies officially support it.

Fixed

• TravisCI configuration.

Added

• Laravel 8 compatibility.

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().

Changed

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

Added

• Laravel 7 compatibility.

Changed

• configuration setting for reader to use array-notation, to allow config caching. Thanks @tooblue !

Fixes

• logger instantiation to not add logger if it doesn't exist.

Added

• logger injection in chain provider.

Added

• Laravel 6.1 compatibility.

Added

• Laravel 6.0 compatibility.

Fixed

• initialization of geocoder adapter.

Added

• Guzzle HTTP Response Factory out of the box, thanks @trippo for reporting that.

Removed

• string helper methods to future-proof things, as they are deprecated, thanks @nmfzone for submitting that PR!

Added

• Laravel 5.8 compatibility.

Added

• ->toJson() method when querying results.

Added

• Laravel 5.7 compatibility.

Changed

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