rinvex / laravel-settings
Rinvex Settings is a Laravel package for setting management. You can add, update, and delete application settings with ease, and use like the detaul Laravel config options. It comes with the ability to override config options on runtime, and supports tenantable features out of the box.
This package's canonical repository appears to be gone and the package has been frozen as a result.
Requires
- php: ^8.1.0
- illuminate/console: ^10.0.0 || ^11.0.0
- illuminate/contracts: ^10.0.0 || ^11.0.0
- illuminate/database: ^10.0.0 || ^11.0.0
- illuminate/filesystem: ^10.0.0 || ^11.0.0
- illuminate/support: ^10.0.0 || ^11.0.0
- rinvex/laravel-support: ^7.0.0
- spatie/eloquent-sortable: ^4.0.0
- spatie/laravel-sluggable: ^3.3.0
- spatie/laravel-translatable: ^6.0.0
- symfony/console: ^6.2.0
Requires (Dev)
- codedungeon/phpunit-result-printer: ^0.32.0
- illuminate/container: ^10.0.0 || ^11.0.0
- phpunit/phpunit: ^10.1.0
This package is auto-updated.
Last update: 2024-07-04 09:42:26 UTC
README
Rinvex Settings
Rinvex Settings is a Laravel package for setting management. You can add, update, and delete application settings with ease, and use like the detaul Laravel config options. It comes with the ability to override config options on runtime, and supports tenantable features out of the box.
Installation
-
Install the package via composer:
composer require rinvex/laravel-settings
-
Publish resources (migrations and config files):
php artisan rinvex:publish:settings
-
Execute migrations via the following command:
php artisan rinvex:migrate:settings
-
Done!
Usage
It's worth mentioning that this package API is inspired by default Laravel config options, and it goes hand in hand with it.
Accessing Setting Values
You may easily access your setting values using the global setting
function from anywhere in your application. The
setting values may be accessed using "dot" syntax, which includes the name of the setting group and option you wish
to access. A default value may also be specified and will be returned if the setting option does not exist:
$value = setting('meta.description'); // Retrieve a default value if the configuration value does not exist... $value = config('meta.description', 'Rinvex Settings is a Laravel package for setting management.');
To set configuration values at runtime, pass an array to the config function:
config(['meta.description' => 'You can add, update, and delete application settings with ease, and use like the detaul Laravel config options.']);
More Examples
// Retrieve individual setting $metaKeywords = setting('meta.keywords'); $metaDescription = setting('meta.description'); // Retrieve individual setting of an overridden config option $appName = setting(‘app.name’); // Retrieve group of settings $meta = setting('meta’); // Retrieve a default value if the setting value does not exist $metaAuthor = setting('meta.author', 'Abdelrahman Omran'); // Set runtime setting values setting(['meta.author' => 'Omranic']); setting(['new.setting.key’ => Some Value Here!']);
Notes:
- This package automatically spins through all settings and load them into an IoC collection.
- It supports setting nesting, tenantable features if available, and config option override as well.
- It executes early on application booting, which makes all options available for use across the whole app.
- The underlying class for a setting is basically Laravel Eloquent model, which means you can use it the same intuitive way.
Configuration Caching
To give your application a speed boost, you should cache all of your settings into a single file using the setting:cache
Artisan command.
This will combine all of the configuration options for your application into a single file which can be quickly loaded by the framework.
You should typically run the php artisan setting:cache
command as part of your production deployment process. The command should not
be run during local development as settings will frequently need to be changed during the course of your application's development.
Notes:
- Settings caching is disabled at the moment, until we figure out a way to handle tenantable settings cache, as it dynamically overrides app-wide global settings by nature.
Advanced Usage
Settings can override default config options. Be aware this might change the default behavior of your application if not used wisely.
To override any config option using settings, simply create a new setting with the same key as that config option (example: app.name
),
then set the override_config
attribute to TRUE, set the override value you want to set, and save the setting. Next time your app
is booted and you call config('app.name')
, it will automatically retrieve the value you set for setting('app.name')
.
Notes:
- This
override_config
feature is not intended to override some of the core config options like db connection details for example, as db connection config options are required and loaded at a very early stage. Be cautious when overriding config options.
Changelog
Refer to the Changelog for a full history of the project.
Support
The following support channels are available at your fingertips:
Contributing & Protocols
Thank you for considering contributing to this project! The contribution guide can be found in CONTRIBUTING.md.
Bug reports, feature requests, and pull requests are very welcome.
Security Vulnerabilities
We want to ensure that this package is secure for everyone. If you've discovered a security vulnerability in this package, we appreciate your help in disclosing it to us in a responsible manner.
Publicly disclosing a vulnerability can put the entire community at risk. If you've discovered a security concern, please email us at help@rinvex.com. We'll work with you to make sure that we understand the scope of the issue, and that we fully address your concern. We consider correspondence sent to help@rinvex.com our highest priority, and work to address any issues that arise as quickly as possible.
After a security vulnerability has been corrected, a security hotfix release will be deployed as soon as possible.
About Rinvex
Rinvex is a software solutions startup, specialized in integrated enterprise solutions for SMEs established in Alexandria, Egypt since June 2016. We believe that our drive The Value, The Reach, and The Impact is what differentiates us and unleash the endless possibilities of our philosophy through the power of software. We like to call it Innovation At The Speed Of Life. That’s how we do our share of advancing humanity.
License
This software is released under The MIT License (MIT).
(c) 2016-2022 Rinvex LLC, Some rights reserved.