efriandika/laravel-settings

Laravel 5 Persistent Settings

, _(*1)

Laravel-Settings

Laravel 5.1.x Persistent Settings (Database + Cache), _(*2)

Attention: for update to v1.2.0

Re-Publish new migration file, _(*3)

$ php artisan vendor:publish --provider="Efriandika\LaravelSettings\SettingsServiceProvider" --force

And run, _(*4)

$ php artisan migrate

How to Install

Require this package with composer (Packagist) using the following command:, _(*5)

composer require efriandika/laravel-settings

or modify your composer.json:, _(*6)

   "require": {
      "efriandika/laravel-settings": "1.*"
   }

then run composer update:, _(*7)

After updating composer, Register the ServiceProvider to the providers array in config/app.php, _(*8)

'Efriandika\LaravelSettings\SettingsServiceProvider',

Add an alias for the facade to aliases array in your config/app.php, _(*9)

'Settings'  => Efriandika\LaravelSettings\Facades\Settings::class,

Publish the config and migration files now (Attention: This command will not work if you don't follow previous instruction):, _(*10)

$ php artisan vendor:publish --provider="Efriandika\LaravelSettings\SettingsServiceProvider" --force

Change config/settings.php according to your needs. If you change db_table, don't forget to change the table's name in the migration file as well., _(*11)

Create the settings table., _(*12)

$ php artisan migrate

How to Use it?

Set a value, _(*13)

Settings::set('key', 'value');

Get a value, _(*14)

$value = Settings::get('key');

Get a value with Default Value., _(*15)

$value = Settings::get('key', 'Default Value');

Note: If key is not found (null) in cache or settings table, it will return default value, _(*16)

Get a value via an helper, _(*17)

$value = settings('key');
$value = settings('key', 'default value');

Forget a value, _(*18)

Settings::forget('key');

Forget all values, _(*19)

Settings::flush();

Fallback to Laravel Config (available in v1.2.0)

How to activate?, _(*20)

// Change your config/settings.php
'fallback'   => true

Example, _(*21)

/* 
 * If the value with key => mail.host is not found in cache or DB of Larave Settings
 * it will return same value as config::get('mail.host');
 */     
Settings::get('mail.host');

Note: It will work if default value in laravel setting is not set, _(*22)

Changelogs

v1.2.0 - Dec 16th, 2015, _(*23)

• Bugs fix
• Adding Feature: Fallback Value

To Do

License

The Laravel 5 Persistent Settings is open-sourced software licensed under the MIT license, _(*24)