Download the PHP package rinvex/laravel-settings without Composer

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

1. Install the package via composer:

2. Publish resources (migrations and config files):

3. Execute migrations via the following command:

4. 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:

To set configuration values at runtime, pass an array to the config function:

More Examples

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:

• Chat on Slack
• Help on Email
• Follow on Twitter

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.

• Versioning
• Pull Requests
• Coding Standards
• Feature Requests
• Git Flow

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 [email protected] 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.