CHANGELOG.md

Changelog

All notable changes to laravel-settings will be documented in this file

Unreleased

• Make spatie/data-transfer-object dependency optional. (#160)

3.9.0 - 2026-05-26

What's Changed

• Adds a cache prefix resolver by @leobeal in #362

New Contributors

• @leobeal made their first contribution in #362

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.8.1...3.9.0

3.8.1 - 2026-05-22

What's Changed

• cast env('SETTINGS_CACHE_ENABLED') to boolean by @ismaail in #361

New Contributors

• @ismaail made their first contribution in #361

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.8.0...3.8.1

3.8.0 - 2026-04-28

What's Changed

• chore(deps): bump dependabot/fetch-metadata from 2.5.0 to 3.0.0 by @dependabot[bot] in #359
• chore(deps): bump dependabot/fetch-metadata from 3.0.0 to 3.1.0 by @dependabot[bot] in #360
• fix(settings): update settings migrator and repositories to deal with locked attribute on rename operation by @carlos-mora in #358

New Contributors

• @carlos-mora made their first contribution in #358

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.7.2...3.8.0

3.7.2 - 2026-03-17

What's Changed

• Add ShouldBeEncrypted attribute by @willrowe in #353

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.7.1...3.7.2

3.7.1 - 2026-03-16

What's Changed

• Add type hint to up method and use config for table name by @bernhardh in #355
• Allow phpdocumentor/type-resolver v2 for Laravel 12 compatibility by @milorojas in #354

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.7.0...3.7.1

3.7.0 - 2026-02-09

What's new

• Add support for Laravel's memoized cache driver (Cache::memo(), requires Laravel 12.9+)

When enabled, settings cache values are stored in memory during a single request, preventing repeated cache store hits.

Configuration

// config/settings.php
'cache' => [
    'enabled' => true,
    'memo' => true, // or env('SETTINGS_CACHE_MEMO', false)
],

Per-repository configuration is also supported.

Backwards compatible — on Laravel versions without Cache::memo(), the option is silently ignored.

3.5.1 - 2025-12-03

What's Changed

• fix issue 343 Fixed: When multiple tenants have the same cache key, tenants cannot be distinguished by @Wsmallnews in #344
• Revert "Update migration file publishing with timestamp" by @rubenvanassche in #349

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.5.0...3.5.1

3.5.0 - 2025-10-24

What's Changed

• Register the auto discover cache and clear commands as optimize commands by @willrowe in #327
• Update migration file publishing with timestamp by @samuelterra22 in #341
• [Feature] Added ArrayDataCast to cast arrays of Laravel Data by @serious-angel in #334

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.4.4...3.5.0

3.4.4 - 2025-04-11

• Fix #319

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.4.3...3.4.4

3.4.3 - 2025-04-11

What's Changed

• Do not save settings with missing migrations by @gazben in #313

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.4.2...3.4.3

3.4.2 - 2025-02-14

What's Changed

• Fill missing settings with default values by @gazben in #298

New Contributors

• @gazben made their first contribution in #298

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.4.1...3.4.2

3.4.1 - 2025-01-31

What's Changed

• chore(deps): bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in #309
• Change out of date stubs in README by @GrandadEvans in #310
• Support Illuminate\Support\Carbon as cast by @Propaganistas in #311
• chore: fix typo by @danjohnson95 in #306

New Contributors

• @GrandadEvans made their first contribution in #310
• @Propaganistas made their first contribution in #311
• @danjohnson95 made their first contribution in #306

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.4.0...3.4.1

3.4.0 - 2024-09-20

What's Changed

• Update README.md by @marventhieme in #290
• Update README.md by @marventhieme in #291
• Feat: add exists in migrator by @akshit-arora in #289

New Contributors

• @marventhieme made their first contribution in #290
• @akshit-arora made their first contribution in #289

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.3.3...3.4.0

3.3.3 - 2024-08-13

What's Changed

• Handle Parentheses On Anonymous Settings Migrations by @Magnesium38 in #280

New Contributors

• @Magnesium38 made their first contribution in #280

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.3.2...3.3.3

3.3.2 - 2024-03-22

What's Changed

• [3.x] Fix PHP 7.4 Compatibilty by @Rizky92 in #264
• Update MakeSettingCommand.php by @hamzaelmaghari in #262

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.3.1...3.3.2

3.3.1 - 2024-03-13

What's Changed

• fix when base path is app path by @mvenghaus in #259

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.3.0...3.3.1

3.3.0 - 2024-02-19

What's Changed

• Update composer.json to use Larastan Org by @arnebr in #252
• Add support for laravel 11 by @shuvroroy in #256
• Added settings driven custom encoder/decoder by @naxvog in #250

Full Changelog: https://github.com/spatie/laravel-settings/compare/3.2.3...3.3.0

3.2.3 - 2023-12-04

• Revert "Use Illuminate\Database\Eloquent\Casts\Json if possible" (#249)

3.2.2 - 2023-12-01

• Use Illuminate\Database\Eloquent\Casts\Json if possible (#241)

3.2.1 - 2023-09-15

• Change provider tag name for config (#233)

3.2.0 - 2023-07-05

• Add support for database-less fakes

3.1.0 - 2023-05-11

• Add support for nullable enum properties
• Updates to the upgrade guide

3.0.0 - 2023-04-28

• Allow repositories to update multiple settings at once (#213 )
• The default location where searching for settings happens is now app_path('Settings') instead of app_path()
• The default discovered_settings_cache_path is changed

2.8.3 - 2023-03-30

• Remove doctrine as a dependency

2.8.2 - 2023-03-10

• Fix remigration problems with anonymous settings migrations

2.8.1 - 2023-03-02

• Show message and target path after setting migration created (#203)
• Follow Laravel's namespace convention in MakeSettingCommand (#200)
• Update MakeSettingsMigrationCommand.php (#205)
• Revert "Add support for structure discoverer"( #207)

2.8.0 - 2023-02-10

• Drop Laravel 8 support
• Drop PHP 8.0 support
• Use spatie/structures-discoverer for finding settings

2.7.0 - 2023-02-01

• Add Laravel 10 Support (#192)
• Update make:settings migration class as anonymous class (#189)
• Use correct namespace in make:settings command (#190)

2.6.1 - 2023-01-06

• Add current date to the settings migration file (#178)
• Add command to make new settings (#181)

1.6.1 - 2022-12-21

• create settings migration with current date (#179)

2.6.0 - 2022-11-24

• Add support for caching on repository level

2.5.0 - 2022-11-10

• Remove deprecated package
• Add laravel data cast
• Add support for PHP 8.2
• Remove PHP 7.4 support
• Remove dto cast from default config

2.4.5 - 2022-09-28

• Add deleteIfExists() method to migrator (#154)

2.4.4 - 2022-09-07

• cache encrypted settings

Please, be sure to clear your cache since settings classes with encrypted properties will crash due to the cached versions missing a proper encrypted version of the property. Clearing and caching again after installing this version resolves this problem and is something you probably should always do when deploying to production!

2.4.3 - 2022-08-10

• add rollback to migration

2.4.2 - 2022-06-17

• use Facade imports instead of aliases (#132)

2.4.1 - 2022-04-07

• Switch to using scoped instances instead of singletons (#129)

2.4.0 - 2022-03-22

What's Changed

• Add TTL config for settings cache by @AlexVanderbist in #122

New Contributors

• @AlexVanderbist made their first contribution in #122

Full Changelog: https://github.com/spatie/laravel-settings/compare/2.3.3...2.4.0

2.3.3 - 2022-03-18

• fix debug info method
• convert PHPUnit to Pest (#118)

2.3.2 - 2022-02-25

• Allow migrations without a value (#113)

2.3.1 - 2022-02-04

• Add support for Laravel 9
• Fix cache implementation with casts
• Remove Psalm
• Add PHPStan

2.2.0 - 2021-10-22

• add support for multiple migration paths (#92)

2.1.12 - 2021-10-14

• add possibility to check if setting is locked or unlocked (#89)

2.1.11 - 2021-08-23

• ignore abstract classes when discovering settings (#84)

2.1.10 - 2021-08-17

• add support for null in DateTime casts

2.1.9 - 2021-07-08

• fix empty call not working when properties weren't loaded

2.1.8 - 2021-06-21

• fix fake settings not working with Arrayable

2.1.7 - 2021-06-08

• add support for refreshing settings

2.1.6 - 2021-06-03

• add support for defining the database connection table

2.1.5 - 2021-05-21

• fix some casting problems
• update php-cs-fixer

2.1.4 - 2021-04-28

• added fallback for settings.auto_discover_settings (#63)
• add support for spatie/data-transfer-object v3 (#62)

2.1.3 - 2021-04-14

• add support for spatie/temporary-directory v2

2.1.2 - 2021-04-08

• skip classes with errors when discovering settings

2.1.1 - 2021-04-07

• add better support for nullable types in docblocks

2.1.0 - 2021-04-07

• add casts to migrations (#53)
• add original properties to SavingSettings event (#57)

2.0.1 - 2021-03-05

• add support for lumen

2.0.0 - 2021-03-03

• settings classes:
• properties won't be loaded when constructed but when requested
• receive a SettingsMapper when constructed
• faking settings will now only request non-given properties from the repository
• rewritten SettingsMapper from scratch
• removed SettingsPropertyData and ettingsPropertyDataCollection
• changed signatures of SavingSettings and LoadingSettings events
• added support for caching settings
• renamed cache_path in settings.php to discovered_settings_cache_path

1.0.8 - 2021-03-03

• fix for properties without defined type

1.0.7 - 2021-02-19

• fix correct 'Event' facade (#30)

1.0.6 - 2021-02-05

• add support for restoring settings after a Laravel schema:dump

1.0.5 - 2021-01-29

• bump the doctrine/dbal dependency

1.0.4 - 2021-01-08

• add support for getting the locked settings

1.0.3 - 2020-11-26

• add PHP 8 support

1.0.2 - 2020-11-26

• fix package namespace within migrations (#9)

1.0.1 - 2020-11-18

• fix config file tag (#4)
• fix database migration path exists (#7)

1.0.0 - 2020-11-09

• initial release