PHPackages laravelbap/settings - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. laravelbap/settings ActiveLibrary[Utility & Helpers](/categories/utility) laravelbap/settings =================== Persistent settings package for Laravel framework. 4.0.0(4y ago)0669↓25%MITPHPPHP ^7.2.5 || ^8.0 Since Jun 29Pushed 4y agoCompare [ Source](https://github.com/laravelbap/settings)[ Packagist](https://packagist.org/packages/laravelbap/settings)[ RSS](/packages/laravelbap-settings/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (6)Versions (10)Used By (0) Persistent Settings for Laravel 5 ================================= [](#persistent-settings-for-laravel-5) Forked from Updated to Laravel 8 --------------------------------------------------------------------------- [](#forked-from-httpsgithubcomedvinaskrucassettingsupdated-to-laravel-8) Persistent settings package for Laravel 8. ------------------------------------------ [](#persistent-settings-package-for-laravel-8) - Driver support - Cache settings via laravel cache - Encrypt / Decrypt setting values - Fire events after action - Override config values - Helper function - Settings by context - Serialize values --- Installation ------------ [](#installation) Require this package in your composer.json: ``` "require": { "laravelbap/settings": "3.0.0" } ``` ### Version matrix [](#version-matrix) Laravel VersionPackage version7= 3.0.08= 4.0.0### Registering to use it with laravel [](#registering-to-use-it-with-laravel) Add following lines to `app/config/app.php` ServiceProvider array ``` Laravelbap\Settings\Providers\SettingsServiceProvider::class, ``` Alias array ``` 'Settings' => Laravelbap\Settings\Facades\Settings::class ``` ### Publishing config file [](#publishing-config-file) If you want to edit default config file, just publish it to your app folder. ``` php artisan vendor:publish --provider="Laravelbap\Settings\Providers\SettingsServiceProvider" --tag="config" ``` Usage ----- [](#usage) ### Configuration [](#configuration) Package comes with several configuration options. SettingDescription`default`Setting repository driver.`cache`Enable or disable setting cache.`encryption`Enable or disable setting value encryption.`events`Enable or disable event firing.`repositories`Config of all repositories which can be used.`key_generator`Key generator class.`context_serializer`Context serializer class.`value_serializer`Value serializer class.`override`Allows you to override values in Laravel config array.### Creating table for database driver [](#creating-table-for-database-driver) To use database driver you have to create table in your database. Package provides default table migration, to create it you need to execute artisan command: ``` $ php artisan settings:table ``` ### Methods [](#methods) #### Set value [](#set-value) Set setting value. ``` Settings::set($key, $value = null); ``` #### Get value [](#get-value) Get setting value, default value is returned when no value found. ``` Settings::get($key, $default = null); ``` #### Check value [](#check-value) Determine if setting exists. ``` Settings::has($key); ``` #### Forget value [](#forget-value) Forget setting value from repository. ``` Settings::forget($key); ``` #### Set context [](#set-context) Setting values may be used in certain context. Context can be set using method `context()`. ``` Settings::context(new Context(['user' => 1])); ``` Context is reset after call of one these methods `set`, `get`, `has`, `forget`. Example how to use settings for different contexts. ``` $userContext1 = new Context(['user' => 1]); $userContext2 = new Context(['user' => 2]); Settings::context($userContext1)->set('key', 'value1'); Settings::context($userContext2)->set('key', 'value2'); // retrieve settings $userValue1 = Settings::context($userContext1)->get('key'); // value1 $userValue2 = Settings::context($userContext2)->get('key'); // value2 ``` ### Helpers [](#helpers) #### Settings service instance [](#settings-service-instance) Resolve settings service instance. ``` settings(); ``` #### Set value [](#set-value-1) Set setting value. ``` settings([$key => $value]); ``` Set setting value for a context. ``` settings([$key => $value], new Context(['user' => 1])); ``` #### Get value [](#get-value-1) Get setting value, default value is returned when no value found. ``` settings($key, $default = null); ``` Getting value for a context. ``` settings($key, $default, new Context(['user' => 1])); ``` ### Events [](#events) Events gets fired if this is not disabled via config (enabled by default). #### settings.checking: $key [](#settingschecking-key) Fired before checking if value is present in repository. ParameterTypeParameter description$keystringSetting key.$contextnull or ContextSetting context.#### settings.has: $key [](#settingshas-key) Fired after checking if value is present in repository. ParameterTypeParameter description$keystringSetting key.$statusboolIf setting exists `true` is passed, otherwise `false`$contextnull or ContextSetting context.#### settings.getting: $key [](#settingsgetting-key) Fired before retrieving value from repository. ParameterTypeParameter description$keystringSetting key.$defaultmixedDefault setting value.$contextnull or ContextSetting context.#### settings.get: $key [](#settingsget-key) Fired after retrieving value from repository. ParameterTypeParameter description$keystringSetting key.$valuemixedRetrieved setting value.$defaultmixedDefault setting value.$contextnull or ContextSetting context.#### settings.setting: $key [](#settingssetting-key) Fired before setting value to repository. ParameterTypeParameter description$keystringSetting key.$valuemixedSetting value to be set.$contextnull or ContextSetting context.#### settings.set: $key [](#settingsset-key) Fired after setting value to repository. ParameterTypeParameter description$keystringSetting key.$valuemixedSetting value to be set.$contextnull or ContextSetting context.#### settings.forgetting: $key [](#settingsforgetting-key) Fired before forgetting value. ParameterTypeParameter description$keystringSetting key.$contextnull or ContextSetting context.#### settings.forget: $key [](#settingsforget-key) Fired after forgetting value. ParameterTypeParameter description$keystringSetting key.$contextnull or ContextSetting context. ### Health Score 33 — LowBetter than 75% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity16 Limited adoption so far Community6 Small or concentrated contributor base Maturity74 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~390 days Recently: every ~535 days Total 7 Last Release 1632d ago Major Versions 1.2.0 → 2.0.02016-01-19 2.0.0 → 5.8.x-dev2019-11-26 3.0.0 → 4.0.02021-11-28 PHP version history (4 changes)1.0.0PHP >=5.3.0 1.2.0PHP ^5.5|^7.0 5.8.x-devPHP ^7.2 4.0.0PHP ^7.2.5 || ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/95f0b8945d972a13578fea589c37580da3758afdc12fb562cc6bd872d30ce558?d=identicon)[laravelbap](/maintainers/laravelbap) --- Top Contributors [![edvinaskrucas](https://avatars.githubusercontent.com/u/2177571?v=4)](https://github.com/edvinaskrucas "edvinaskrucas (32 commits)") --- Tags laravelSettingspersistent settings ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/laravelbap-settings/health.svg) ``` [![Health](https://phpackages.com/badges/laravelbap-settings/health.svg)](https://phpackages.com/packages/laravelbap-settings) ``` ### Alternatives [barryvdh/laravel-ide-helper Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion. 14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[yajra/laravel-datatables-oracle jQuery DataTables API for Laravel 4.9k33.8M339](/packages/yajra-laravel-datatables-oracle)[edvinaskrucas/settings Persistent settings package for Laravel framework. 22483.1k1](/packages/edvinaskrucas-settings)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum)[tehwave/laravel-achievements Simple, elegant Achievements the Laravel way 7012.8k](/packages/tehwave-laravel-achievements)[zonneplan/laravel-module-loader Module loader for Laravel 24118.4k](/packages/zonneplan-laravel-module-loader) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)