glorand/laravel-model-settings

Full Changelog: 9.0.0...9.0.1

V9 is a major refactor that unifies the storage backends into a single, configuration-driven system. This release simplifies the API surface, reduces boilerplate, and provides better extensibility for custom drivers.

🔄 Breaking Changes
Migration Required — see MIGRATION_GUIDE_8_to_9.md

Removed HasSettingsField, HasSettingsTable, HasSettingsRedis traits
Removed flat settings_* config keys (env vars unchanged)
Requires PHP 8.2+ and Laravel 12–13 (dropped 10/11, PHP 8.1)
Mutations (set, update, delete, etc.) now persist only overrides; defaults are no longer copied into storage
Validation runs against the effective (merged) result, not just persisted data
table and redis drivers throw ModelSettingsException when model has no primary key
Redis driver deletes the storage key on clear() instead of storing empty array

Added

• Single HasSettings trait with configuration-driven driver selection (MODEL_SETTINGS_DRIVER env / driver config / per-model $settingsDriver property)
• SettingsManagerFactory singleton with extend() for registering custom drivers at runtime
• Driver-scoped config: driver-specific keys live under drivers.<name>.*
• Optional Redis driver options: drivers.redis.connection (named connection) and drivers.redis.key_prefix

Changed (BREAKING)

• Removed the HasSettingsField, HasSettingsTable and HasSettingsRedis traits - see MIGRATION_GUIDE_8_to_9.md
• Removed the flat settings_* config keys (env variable names are unchanged)
• Requires PHP ^8.2 and Laravel 12/13 (drop Laravel 10/11, PHP 8.1)
• Mutations (set, update, delete, setMultiple, deleteMultiple) persist only the stored overrides - defaults are no longer copied into storage; validation runs against the effective (default-merged) result
• The table and redis drivers throw ModelSettingsException when the model has no primary key yet
• The redis driver deletes the storage key when settings are cleared instead of storing an empty array

Fix

• The field driver's internal schema-check cache key now includes the table name (two models on different tables no longer share one cached result)

What's Changed

• Laravel 13.x Compatibility by @laravel-shift in #134
• Minor layout change readme.md by @tobya in #133

New Contributors

• @tobya made their first contribution in #133

Full Changelog: 8.0.3...8.0.4

Removed Model::getConnectionName() override and moved fallback to eac…

…h call. (#122)

What's Changed

• fix: nullable type parameter deprecation on PHP 8.4

New Contributor

@jamesdb made their first contribution in #128

What's Changed

• [Proposal] Rename HasSettings::getRules to HasSettings::getSettingsRules by @ipswise in #123

New Contributors

• @ipswise made their first contribution in #123

Full Changelog: 8.0.0...8.0.1

Added

• Rename HasSettings::getRules to HasSettings::getSettingsRules

What's Changed

• Laravel 12.x Compatibility by @laravel-shift in #126

Full Changelog: 7.0.0...8.0.0

Added

• Add support for Laravel 12

What's Changed

• Apply fixes from StyleCI by @glorand in #113
• Laravel 11 by @glorand in #120

Full Changelog: 6.0.3...7.0.0

Added

• Add support for Laravel 11
• 8.1 min. php version

Fix "Segmentation fault" for model inheritance (#109)

* Fix "Segmentation fault" for model inheritance

* Fix formatting

Added

• Add support for Laravel 9 by @belzaaron
• DROP Laravel 7,8 support
• 8.0 min. php version

Fix

• fix validation variable name

Added

• Validation system for settings data

Added

• Using another method name other than settings()

Fix param type

Added

• PHP8 support

Added

• Refactor the work with default settings (flatten arrays)

Added

• Refactor unit tests

Added

• Setup connection of the model in HasSettingsTableTrait

Added

• Update README

Added

• Add support for Laravel 8
• Drop support for Laravel 5.8 and lower
• Drop support for PHP 7.1 and lower

Added

• HasSettingsField now adheres to $connection override on model Ref. task

Fix

• code refactor

Fix

• default configs for a table in model_settings.php config file

Fix

• code refactor
• use Cache facade instead of cache() helper function

Fix

• github actions

Fix

• "empty()" - to check if the model has empty setting

Fix

• "exist()" - to check if the model has valid setting

Fix

• https://github.com/glorand/laravel-model-settings/issues/50

• add support for Laravel 7

Bugfix

Fix

• https://github.com/glorand/laravel-model-settings/issues/40

Fix

• https://github.com/glorand/laravel-model-settings/issues/36

Fix

• https://github.com/glorand/laravel-model-settings/issues/33

Fix

• Check column settings exists directly on the database table

Added

• Use cache in case of Table Settings Ref. task
• Refactor

Added

• Manage array type settings

Added

• Redis support

Added

• Default settings on Model

Added

• Compatibility with PSR-16, CacheInterface

Added

• Test for console commands

Added

• Configure persistence for settings in case of Field Type (HasSettingsField)

Added

• Command to create the table for settings
• Dynamic name for the settings table and field

Added

• Console Commands

Added

• Initial release