PHPackages agunbuhori/settings-manager - 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. agunbuhori/settings-manager ActiveLibrary[Utility & Helpers](/categories/utility) agunbuhori/settings-manager =========================== Laravel settings manager package v1.6(4mo ago)157MITPHP Since Sep 12Pushed 4mo agoCompare [ Source](https://github.com/agunbuhori/laravel-settings-manager)[ Packagist](https://packagist.org/packages/agunbuhori/settings-manager)[ RSS](/packages/agunbuhori-settings-manager/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (6)DependenciesVersions (7)Used By (0) 📦 Settings Manager for Laravel ============================== [](#-settings-manager-for-laravel) A simple and flexible **settings manager package** for Laravel. It helps you store, retrieve, and manage application settings in the database — with support for: - ✅ Key/value settings - ✅ Typed values (`string`, `integer`, `float`, `boolean`, `array`) - ✅ Dot notation for nested arrays - ✅ Cache support for performance - ✅ Bag & group support (multi-tenant, multi-context) - ✅ Bulk get (`getMany()`) - ✅ Flush cache by bag/group - ✅ REST API endpoints for settings management --- 🚀 Installation -------------- [](#-installation) Require the package via Composer: ``` composer require agunbuhori/settings-manager ``` Publish the config file: ``` php artisan vendor:publish --tag=settings-manager ``` Run the migrations: ``` php artisan migrate ``` --- ⚙️ Configuration ---------------- [](#️-configuration) File: `config/settings-manager.php` ``` return [ 'enable_cache' => true, 'cache_expiration' => 86400, // 1 day in seconds 'enable_api' => true, ]; ``` --- 🛠 Usage ------- [](#-usage) ### 1. Basic set & get [](#1-basic-set--get) ``` settings()->set('site_name', 'My App'); $name = settings()->get('site_name'); // "My App" ``` --- ### 2. Arrays & dot notation [](#2-arrays--dot-notation) ``` settings()->set('app.theme.color', 'blue'); settings()->set('app.theme.layout', 'grid'); $color = settings()->get('app.theme.color'); // "blue" ``` --- ### 3. Typed values [](#3-typed-values) ``` settings()->set('max_users', 100); // integer settings()->set('pi_value', 3.14); // float settings()->set('is_active', true); // boolean settings()->set('allowed_ips', ['1.1.1.1', '8.8.8.8']); // array ``` --- ### 4. Multiple settings at once [](#4-multiple-settings-at-once) ``` $data = settings()->getMany(['site_name', 'is_active', 'max_users']); // or set many settings()->setMany(['domain' => 'www.example.com', 'name' => 'My cool website']); /* [ "site_name" => "My App", "is_active" => true, "max_users" => 100 ] */ ``` --- ### 5. Bag-specific settings (multi-tenant) [](#5-bag-specific-settings-multi-tenant) ``` // Bag #1 settings()->bag(1)->set('currency', 'USD'); // Bag #2 settings()->bag(2)->set('currency', 'EUR'); // Retrieve per bag settings()->bag(1)->get('currency'); // USD settings()->bag(2)->get('currency'); // EUR ``` --- ### 6. Group settings (multi-tenant) [](#6-group-settings-multi-tenant) ``` // Bag #1 settings()->bag(1, 'user')->set('currency', 'USD'); settings()->bag(1, 'store')->set('currency', 'USD'); ``` --- ### 7. General settings (no bag) [](#7-general-settings-no-bag) ``` settings()->general()->set('timezone', 'UTC'); settings()->general()->get('timezone'); // UTC ``` --- ### 8. Optionally set cache [](#8-optionally-set-cache) ``` settings()->general()->set('timezone', 'UTC', true); // will be saved to cache settings()->general()->set('country', 'USA', false); // won't be saved to cache ``` --- ### 9. Flush cache [](#9-flush-cache) ``` // Flush all settings cache settings()->flush(); // Flush cache for a specific bag settings()->flush(bag: 1); // Flush cache for a specific bag and group settings()->flush(bag: 1, group: 'preferences'); ``` --- 💼 Bags and Groups ----------------- [](#-bags-and-groups) In this settings manager, **bags** are used to define the main scope of your settings. You can think of a bag as a container for a specific context, such as an office, a user, or a project. **Groups** are optional sub-scopes inside a bag that help organize settings further, for example `profile`, `preferences`, or `billing`. ### Examples [](#examples) ``` // Bag as an office (office ID = 10) settings()->bag(10)->set('timezone', 'Asia/Jakarta'); $tz = settings()->bag(10)->get('timezone'); // "Asia/Jakarta" // Bag as a user (user ID = 50) with a group "profile" settings()->bag(50, 'profile')->set('language', 'id'); $lang = settings()->bag(50, 'profile')->get('language'); // "id" // Same user bag with another group "preferences" settings()->bag(50, 'preferences')->set('theme', 'dark'); $theme = settings()->bag(50, 'preferences')->get('theme'); // "dark" ``` 🌐 API Endpoints --------------- [](#-api-endpoints) If `enable_api` is set to `true`, the following routes are auto-loaded: ``` GET /settings?per_page=10&keys=site_name,is_active GET /settings/{key} POST /settings/{key} (or PUT/PATCH) DELETE /settings/{key} DELETE /settings-cache/clear?bag=1&group=preferences ``` Also you can conditionally authorize ``` SettingsManagerAuthorization::authorize(function () { return auth()->user()->isAdmin(); }); ``` ### Example: Fetch a setting [](#example-fetch-a-setting) ``` GET /settings/site_name → { "value": "My App" } ``` ### Example: Update a setting [](#example-update-a-setting) ``` POST /settings/site_name { "value": "New Name" } → { "message": "Setting updated successfully", "data": "New Name" } ``` ### Example: Delete a setting [](#example-delete-a-setting) ``` DELETE /settings/site_name → { "message": "Setting deleted successfully", "data": null } ``` ### Example: Flush cache [](#example-flush-cache) ``` DELETE /settings-cache/clear?bag=1&group=preferences → { "message": "Cache cleared successfully" } ``` --- 🔑 Middleware Support -------------------- [](#-middleware-support) All API routes are wrapped with `SettingsManagerMiddleware`. This allows you to pass **bag** and **group** via query string: ``` GET /settings?bag=1&group=users ``` That way, your API can handle multiple contexts (multi-tenant, multi-organization, etc.). --- 🧩 Helper Function ----------------- [](#-helper-function) You can call the global helper: ``` settings()->set('foo', 'bar'); $value = settings()->get('foo'); // "bar" ``` --- 📂 Project Structure (important files) ------------------------------------- [](#-project-structure-important-files) ``` app/ config/ settings-manager.php routes/ api.php // Settings API routes database/ migrations/ create_settings_table.php src/ Controllers/SettingController.php Middlewares/SettingsManagerMiddleware.php Models/Setting.php SettingsManager.php SettingsBagManager.php ``` --- ✅ Summary --------- [](#-summary) - Store any type of settings (`string`, `int`, `float`, `bool`, `array`) - Use dot notation for arrays (`app.theme.color`) - Switch between **general**, **bag**, and **group** easily - Cache for faster performance - Full REST API included out of the box --- ❤️ License ---------- [](#️-license) MIT © Agun Buhori ### Health Score 35 — LowBetter than 80% of packages Maintenance75 Regular maintenance activity Popularity10 Limited adoption so far Community6 Small or concentrated contributor base Maturity40 Maturing project, gaining track record 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 ~20 days Recently: every ~0 days Total 6 Last Release 137d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/8fcfcbc80955eb17fab739fae77ff2afcdb22ee007aaff56ca4976f605a7f417?d=identicon)[agunbuhori](/maintainers/agunbuhori) --- Top Contributors [![agunbuhori](https://avatars.githubusercontent.com/u/18309761?v=4)](https://github.com/agunbuhori "agunbuhori (65 commits)") ### Embed Badge ![Health badge](/badges/agunbuhori-settings-manager/health.svg) ``` [![Health](https://phpackages.com/badges/agunbuhori-settings-manager/health.svg)](https://phpackages.com/packages/agunbuhori-settings-manager) ``` ### Alternatives [rareloop/wp-router Router 171.8k](/packages/rareloop-wp-router)[emadha/laravel-dynamic-config This Package makes it possible for users to have their config files stored in a database table, making it easier to customize these values from UI. 141.2k](/packages/emadha-laravel-dynamic-config) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)