PHPackages aliwael/laravel-setting - 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. aliwael/laravel-setting ActiveLibrary[Utility & Helpers](/categories/utility) aliwael/laravel-setting ======================= Persistent settings package for Laravel 02PHPCI failing Since Jul 25Pushed 9mo agoCompare [ Source](https://github.com/aliwael/laravel-setting)[ Packagist](https://packagist.org/packages/aliwael/laravel-setting)[ RSS](/packages/aliwael-laravel-setting/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Persistent settings package for Laravel (يدعم Laravel 12) ========================================================= [](#persistent-settings-package-for-laravel-يدعم-laravel-12) [![Downloads](https://camo.githubusercontent.com/feedcb14f9dba8840afa722f93aa2d55ce15276760c879c99b32d558d3ffde90/68747470733a2f2f706f7365722e707567782e6f72672f616c697761656c2f6c61726176656c2d73657474696e672f642f746f74616c2e737667)](https://github.com/aliwael/laravel-setting)[![StyleCI](https://camo.githubusercontent.com/06cde0dea1746dab188631de2876fad9c8aee78c170e7795b0f7ff4216ec6505/68747470733a2f2f7374796c6563692e696f2f7265706f732f3130313233313831372f736869656c643f7374796c653d666c6174266272616e63683d6d6173746572)](https://styleci.io/repos/101231817)[![License](https://camo.githubusercontent.com/bd0299db3425684d8939bd9fea4ddde8e1d67e46708467a8297489e9d68dc858/68747470733a2f2f706f7365722e707567782e6f72672f616c697761656c2f6c61726176656c2d73657474696e672f6c6963656e73652e737667)](LICENSE.md) This package allows you to save settings in a more persistent way. You can use the database and/or json file to save your settings. You can also override the Laravel config. **يدعم Laravel 12 بشكل كامل.** - Driver support - Helper function - Blade directive - Override config values - Encryption - Custom file, table and columns - Auto save - Extra columns - Cache support Getting Started --------------- [](#getting-started) ### 1. Install [](#1-install) Run the following command: ``` composer require aliwael/laravel-setting ``` ### 2. Register (for Laravel < 5.5) [](#2-register-for-laravel--55) Register the service provider in `config/app.php` ``` aliwael\Setting\Provider::class, ``` Add alias if you want to use the facade. ``` 'Setting' => aliwael\Setting\Facade::class, ``` ### 3. Publish [](#3-publish) Publish config file. ``` php artisan vendor:publish --tag=setting ``` ### 4. Database [](#4-database) Create table for database driver ``` php artisan migrate ``` ### 5. Configure [](#5-configure) You can change the options of your app from `config/setting.php` file Usage ----- [](#usage) You can either use the helper method like `setting('foo')` or the facade `Setting::get('foo')` ### Facade [](#facade) ``` Setting::get('foo', 'default'); Setting::get('nested.element'); Setting::set('foo', 'bar'); Setting::forget('foo'); $settings = Setting::all(); ``` ### Helper [](#helper) ``` setting('foo', 'default'); setting('nested.element'); setting(['foo' => 'bar']); setting()->forget('foo'); $settings = setting()->all(); ``` You can call the `save()` method to save the changes. ### Auto Save [](#auto-save) If you enable the `auto_save` option in the config file, settings will be saved automatically every time the application shuts down if anything has been changed. ### Blade Directive [](#blade-directive) You can get the settings directly in your blade templates using the helper method or the blade directive like `@setting('foo')` ### Override Config Values [](#override-config-values) You can easily override default config values by adding them to the `override` option in `config/setting.php`, thereby eliminating the need to modify the default config files and also allowing you to change said values during production. Ex: ``` 'override' => [ "app.name" => "app_name", "app.env" => "app_env", "mail.driver" => "app_mail_driver", "mail.host" => "app_mail_host", ], ``` The values on the left corresponds to the respective config value (Ex: config('app.name')) and the value on the right is the name of the `key` in your settings table/json file. ### Encryption [](#encryption) If you like to encrypt the values for a given key, you can pass the key to the `encrypted_keys` option in `config/setting.php` and the rest is automatically handled by using Laravel's built-in encryption facilities. Ex: ``` 'encrypted_keys' => [ "payment.key", ], ``` ### JSON Storage [](#json-storage) You can modify the path used on run-time using `setting()->setPath($path)`. ### Database Storage [](#database-storage) If you want to use the database as settings storage then you should run the `php artisan migrate`. You can modify the table fields from the `create_settings_table` file in the migrations directory. #### Extra Columns [](#extra-columns) If you want to store settings for multiple users/clients in the same database you can do so by specifying extra columns: ``` setting()->setExtraColumns(['user_id' => Auth::user()->id]); ``` where `user_id = x` will now be added to the database query when settings are retrieved, and when new settings are saved, the `user_id` will be populated. If you need more fine-tuned control over which data gets queried, you can use the `setConstraint` method which takes a closure with two arguments: - `$query` is the query builder instance - `$insert` is a boolean telling you whether the query is an insert or not. If it is an insert, you usually don't need to do anything to `$query`. ``` setting()->setConstraint(function($query, $insert) { if ($insert) return; $query->where(/* ... */); }); ``` ### Custom Drivers [](#custom-drivers) This package uses the Laravel `Manager` class under the hood, so it's easy to add your own storage driver. All you need to do is extend the abstract `Driver` class, implement the abstract methods and call `setting()->extend`. ``` class MyDriver extends aliwael\Setting\Contracts\Driver { // ... } app('setting.manager')->extend('mydriver', function($app) { return $app->make('MyDriver'); }); ``` Changelog --------- [](#changelog) Please see [Releases](../../releases) for more information what has changed recently. Contributing ------------ [](#contributing) Pull requests are more than welcome. You must follow the PSR coding standards. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Denis Duliçi](https://github.com/denisdulici) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [LICENSE](LICENSE.md) for more information. ### Health Score 16 — LowBetter than 5% of packages Maintenance40 Moderate activity, may be stable Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity14 Early-stage or recently created project 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/f857644a47c9be9b76d0a68afe6a212560669db292f23642e87d77eb21461c5c?d=identicon)[aliwael](/maintainers/aliwael) --- Top Contributors [![aliwael](https://avatars.githubusercontent.com/u/36341439?v=4)](https://github.com/aliwael "aliwael (4 commits)") ### Embed Badge ![Health badge](/badges/aliwael-laravel-setting/health.svg) ``` [![Health](https://phpackages.com/badges/aliwael-laravel-setting/health.svg)](https://phpackages.com/packages/aliwael-laravel-setting) ``` ### Alternatives [dhtmlx/connector-php PHP extension for the DHTMLX library 2665.3k2](/packages/dhtmlx-connector-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)