🛡️ 13.2.0 — Laravel 13 cache compatibility

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

13.1.1

Fixed

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

Full Changelog: 13.1.0...13.1.1

13.1.0

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

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

5.0.0: Merge pull request #200 from laravel-shift/l12-compatibility

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.

4.7.0: Merge pull request #198 from laravel-shift/l11-compatibility

Added

• Laravel 11 compatibility. Thanks @laravel-shift!

4.6.0: Merge pull request #194 from laravel-shift/l10-compatibility

Added

• Laravel 10 compatibility.

4.5.1

Removed

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

4.5.0

Added

• Laravel 9 compatibility. Thanks @nabilelmahiri!

4.4.6

Changed

• dependencies to accommodate up-to-date versions.