spatie/laravel-settings

What's Changed

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

New Contributors

• @leobeal made their first contribution in #362

Full Changelog: 3.8.1...3.9.0

What's Changed

• Adds a cache prefix resolver by @leobeal in https://github.com/spatie/laravel-settings/pull/362

New Contributors

• @leobeal made their first contribution in https://github.com/spatie/laravel-settings/pull/362

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

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: 3.8.0...3.8.1

What's Changed

• cast env('SETTINGS_CACHE_ENABLED') to boolean by @ismaail in https://github.com/spatie/laravel-settings/pull/361

New Contributors

• @ismaail made their first contribution in https://github.com/spatie/laravel-settings/pull/361

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

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: 3.7.2...3.8.0

What's Changed

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

New Contributors

• @carlos-mora made their first contribution in https://github.com/spatie/laravel-settings/pull/358

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

What's Changed

• Add ShouldBeEncrypted attribute by @willrowe in #353

Full Changelog: 3.7.1...3.7.2

What's Changed

• Add ShouldBeEncrypted attribute by @willrowe in https://github.com/spatie/laravel-settings/pull/353

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

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: 3.7.0...3.7.1

What's Changed

• Add type hint to up method and use config for table name by @bernhardh in https://github.com/spatie/laravel-settings/pull/355
• Allow phpdocumentor/type-resolver v2 for Laravel 12 compatibility by @milorojas in https://github.com/spatie/laravel-settings/pull/354

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

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.

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.

What's Changed

• Fix caching issues by @rubenvanassche in #350

Full Changelog: 3.5.1...3.6.0

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: 3.5.0...3.5.1

What's Changed

• fix issue 343 Fixed: When multiple tenants have the same cache key, tenants cannot be distinguished by @Wsmallnews in https://github.com/spatie/laravel-settings/pull/344
• Revert "Update migration file publishing with timestamp" by @rubenvanassche in https://github.com/spatie/laravel-settings/pull/349

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

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: 3.4.4...3.5.0

What's Changed

• Register the auto discover cache and clear commands as optimize commands by @willrowe in https://github.com/spatie/laravel-settings/pull/327
• Update migration file publishing with timestamp by @samuelterra22 in https://github.com/spatie/laravel-settings/pull/341
• [Feature] Added ArrayDataCast to cast arrays of Laravel Data by @serious-angel in https://github.com/spatie/laravel-settings/pull/334

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

• Fix #319

Full Changelog: 3.4.3...3.4.4

• Fix #319

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

What's Changed

• Do not save settings with missing migrations by @gazben in https://github.com/spatie/laravel-settings/pull/313

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

What's Changed

• Fill missing settings with default values by @gazben in https://github.com/spatie/laravel-settings/pull/298

New Contributors

• @gazben made their first contribution in https://github.com/spatie/laravel-settings/pull/298

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

What's Changed

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

New Contributors

• @GrandadEvans made their first contribution in https://github.com/spatie/laravel-settings/pull/310
• @Propaganistas made their first contribution in https://github.com/spatie/laravel-settings/pull/311
• @danjohnson95 made their first contribution in https://github.com/spatie/laravel-settings/pull/306

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

What's Changed

• Update README.md by @marventhieme in https://github.com/spatie/laravel-settings/pull/290
• Update README.md by @marventhieme in https://github.com/spatie/laravel-settings/pull/291
• Feat: add exists in migrator by @akshit-arora in https://github.com/spatie/laravel-settings/pull/289

New Contributors

• @marventhieme made their first contribution in https://github.com/spatie/laravel-settings/pull/290
• @akshit-arora made their first contribution in https://github.com/spatie/laravel-settings/pull/289

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

What's Changed

• Handle Parentheses On Anonymous Settings Migrations by @Magnesium38 in https://github.com/spatie/laravel-settings/pull/280

New Contributors

• @Magnesium38 made their first contribution in https://github.com/spatie/laravel-settings/pull/280

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

What's Changed

• [3.x] Fix PHP 7.4 Compatibilty by @Rizky92 in https://github.com/spatie/laravel-settings/pull/264
• Update MakeSettingCommand.php by @hamzaelmaghari in https://github.com/spatie/laravel-settings/pull/262

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

What's Changed

• fix when base path is app path by @mvenghaus in https://github.com/spatie/laravel-settings/pull/259

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

What's Changed

• Update composer.json to use Larastan Org by @arnebr in https://github.com/spatie/laravel-settings/pull/252
• Add support for laravel 11 by @shuvroroy in https://github.com/spatie/laravel-settings/pull/256
• Added settings driven custom encoder/decoder by @naxvog in https://github.com/spatie/laravel-settings/pull/250

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

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

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

• Change provider tag name for config (#233)

• Add support for database-less fakes

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

• 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

• Remove doctrine as a dependency

• Fix remigration problems with anonymous settings migrations

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

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

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

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

• Add support for caching on repository level

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

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

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

• add rollback to migration

• use Facade imports instead of aliases (#132)

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

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

• Allow migrations without a value (#113)

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

• add support for multiple migration paths (#92)

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

• ignore abstract classes when discovering settings (#84)

• add support for null in DateTime casts

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

• fix fake settings not working with Arrayable

• add support for refreshing settings

• add support for defining the database connection table

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

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

• add support for spatie/temporary-directory v2

• skip classes with errors when discovering settings

• add better support for nullable types in docblocks

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

• add support for lumen

• 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

• create settings migration with current date (#179)

• fix for properties without defined type