NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #773 most downloaded on Packagist
Store your application settings
Latest stable
3.10.1
Last release 18 days ago
04 Nov 2026
Release timing varies
gaps range from 2 weeks to 7 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
73 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Fix settings migrations failing with Class not found when the discovered settings cache references a removed or renamed settings class (#369, fixes #3
Class not found when the discovered settings cache references a removed or renamed settings class (#369, fixes #368).This fix does not rebuild discovery or discover newly added classes. When deploying added, renamed, or removed settings classes, run php artisan settings:clear-discovered followed by php artisan settings:discover. Running discovery alone reuses an existing cache. If a migration needs casts from a new or renamed class, rebuild discovery before running migrations. Discovery caching is separate from cached settings values.
This is a non-breaking patch release. PHP and Laravel requirements are unchanged. All seven supported PHP/Laravel test-matrix jobs and PHPStan passed on the reviewed PR head. Local full suites passed on PHP 8.5/Laravel 13 and PHP 8.2/Laravel 12 (160 tests, 500 assertions each), with formatting and Composer validation passing.
Thanks to @MohannadElemary for the fix.
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.10.0...3.10.1
Generate a settings migration alongside a settings class with php artisan make:setting SettingName --migration (or -m). The migration uses the existin
Your coding agent can read these notes before it upgrades. Set up the MCP server →
php artisan make:setting SettingName --migration (or -m). The migration uses the existing configured migration path and can be filled in with properties and defaults.This is an additive, non-breaking release. Existing commands without the new option behave as before. PHP and Laravel requirements are unchanged from 3.9.1.
Thanks to @adereksisusanto for the original feature in #366.
Local validation: 158 tests with 488 assertions passed in the standard test order, along with PHPStan, Composer validation, and formatting checks. Published at the maintainer’s request without waiting for GitHub CI.
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.9.1...3.10.0
Correctly rerun anonymous settings migrations after loading a schema dump, including PSR-12 spacing, multiline declarations, and fully qualified paren
SettingsMigration.Thanks to @pindab0ter for the original fix in #367.
Validation: All seven test matrix jobs and PHPStan passed before merging. Each local matrix run passed 153 tests with 466 assertions; repository-wide formatting and Composer validation also passed.
No breaking application API changes. The end-of-life Laravel 11 support removal is not classified as breaking under this release policy.
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.9.0...3.9.1
Adds a cache prefix resolver by @leobeal in https://github.com/spatie/laravel-settings/pull/362
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.8.1...3.9.0
cast env('SETTINGS_CACHE_ENABLED') to boolean by @ismaail in https://github.com/spatie/laravel-settings/pull/361
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.8.0...3.8.1
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
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.7.2...3.8.0
Add ShouldBeEncrypted attribute by @willrowe in https://github.com/spatie/laravel-settings/pull/353
ShouldBeEncrypted attribute by @willrowe in https://github.com/spatie/laravel-settings/pull/353Full Changelog: https://github.com/spatie/laravel-settings/compare/3.7.1...3.7.2
Add type hint to up method and use config for table name by @bernhardh in https://github.com/spatie/laravel-settings/pull/355
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.7.0...3.7.1
Add support for Laravel's memoized cache driver (Cache::memo(), requires Laravel 12.9+)
Cache::memo(), requires Laravel 12.9+)When enabled, settings cache values are stored in memory during a single request, preventing repeated cache store hits.
// 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.
Fix caching issues by @rubenvanassche in https://github.com/spatie/laravel-settings/pull/350
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.5.1...3.6.0
fix issue 343 Fixed: When multiple tenants have the same cache key, tenants cannot be distinguished by @Wsmallnews in https://github.com/spatie/larave
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.5.0...3.5.1
Register the auto discover cache and clear commands as optimize commands by @willrowe in https://github.com/spatie/laravel-settings/pull/327
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.4.4...3.5.0
- Fix #319 Full Changelog: https://github.com/spatie/laravel-settings/compare/3.4.3...3.4.4
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.4.3...3.4.4
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
Fill missing settings with default values by @gazben in https://github.com/spatie/laravel-settings/pull/298
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.4.1...3.4.2
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
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.4.0...3.4.1
Update README.md by @marventhieme in https://github.com/spatie/laravel-settings/pull/290
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.3.3...3.4.0
Handle Parentheses On Anonymous Settings Migrations by @Magnesium38 in https://github.com/spatie/laravel-settings/pull/280
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.3.2...3.3.3
[3.x] Fix PHP 7.4 Compatibilty by @Rizky92 in https://github.com/spatie/laravel-settings/pull/264
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.3.1...3.3.2
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
Update composer.json to use Larastan Org by @arnebr in https://github.com/spatie/laravel-settings/pull/252
Full Changelog: https://github.com/spatie/laravel-settings/compare/3.2.3...3.3.0
Revert "Use Illuminate\Database\Eloquent\Casts\Json if possible"
Use Illuminate\Database\Eloquent\Casts\Json if possible
Change provider tag name for config
Add support for database-less fakes
Add support for nullable enum properties
Allow repositories to update multiple settings at once
app_path('Settings') instead of app_path()discovered_settings_cache_path is changedRemove doctrine as a dependency
Fix remigration problems with anonymous settings migrations
Show message and target path after setting migration created
Use spatie/structures-discoverer for finding settings
Update make:settings migration class as anonymous class
Add current date to the settings migration file
Add support for caching on repository level
Remove dto cast from default config
Add deleteIfExists() method to migrator
Please, be sure to clear your cache since settings classes with encrypted properties will crash due to the cached versions missing a proper encrypted
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
Switch to using scoped instances instead of singletons
Add TTL config for settings cache by @AlexVanderbist in https://github.com/spatie/laravel-settings/pull/122
Full Changelog: https://github.com/spatie/laravel-settings/compare/2.3.3...2.4.0
- fix debug info method - convert PHPUnit to Pest
Allow migrations without a value
Fix cache implementation with casts
add support for native PHP enums
Serializable interface from settingsadd support for multiple migration paths
add possibility to check if setting is locked or unlocked
ignore abstract classes when discovering settings
add support for null in DateTime casts
null in DateTime castsfix empty call not working when properties weren't loaded
empty call not working when properties weren't loadedfix fake settings not working with Arrayable
Arrayableadd 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
allow spatie/temporary-directory v2
skip classes with errors when discovering settings
add better support for nullable types in docblocks
add original properties to SavingSettings event
- add support for lumen
One column per quarter.