Skip to content

artkonekt/gears

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Settings & Preferences In Laravel Applications

Tests Packagist Stable Version StyleCI Packagist downloads MIT Software License

This Laravel package allows you to manage and save/retrieve settings and preferences in your Laravel application.

  • Settings are user defined values that apply to the application.
  • Preferences are user defined values that apply to a specific user.

Settings and preferences are being managed separately. Values (by default) are being saved to the database (settings and preferences tables) and are cached with the configured cache for your application.

The backend for storing the settings can be completely replaced, so it is possible to store them in anywhere else like MongoDB, ElasticSearch, Firebase, DynamoDB, S3, etc.

Laravel Compatibility

Laravel Gears
5.4 0.9 - 1.1
5.5 0.9 - 1.2
5.6 0.9 - 1.2
5.7 1.1 - 1.2
5.8 1.2 - 1.5
6.x 1.2+
7.x 1.3+
8.x 1.5+
9.x 1.8+

Installation

Minimum requirements (as of v1.9) are PHP 8.0 and Laravel 8.22

Install with composer:

composer require konekt/gears

The service provider and the aliases (facades) get registered automatically.

Usage

Settings are identified by a key (string) and need to be registered in order to be used.

Register Settings

/** @var \Konekt\Gears\Registry\SettingsRegistry $settingsRegistry */
$settingsRegistry = app('gears.settings_registry');

$settingsRegistry->addByKey('mailchimp.api_key');

Saving And Retrieving Settings

use Konekt\Gears\Facades\Settings;

// using the facade:
Settings::set('mailchimp.api_key', '123456789abcdef');
echo Settings::get('mailchimp.api_key');
// '123456789abcdef'

// using the service from the container:
$settings = app('gears.settings');
$settings->set('mailchimp.api_key', 'fbcdef');
echo $settings->get('mailgun.api_key');
// fbcdef

To run the entire CI job suite locally: act -P ubuntu-latest=shivammathur/node:latest

There are many more options and possibilities detailed in the Documentation.

About

Settings & Preferences In Laravel Applications

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages