unisharp / laravel-settings Goto Github PK

View Code? Open in Web Editor NEW

105.0 10.0 26.0 50 KB

Persistent key-value storage for Laravel, json value supported. l10n supported.

License: MIT License

PHP 99.02% Makefile 0.98%

setting config key-value locale laravel

laravel-settings's Introduction

Persistent Settings Manager for Laravel

Simple key-value storage
Support multi-level array (dot delimited keys) structure.
Localization supported.

Installation

Install package

composer require unisharp/laravel-settings

Edit config/app.php (Skip this step if you are using laravel 5.5+)

service provider:

Unisharp\Setting\SettingServiceProvider::class,

class aliases:

'Setting' => Unisharp\Setting\SettingFacade::class,

Create settings table

php artisan vendor:publish --tag=settings
php artisan migrate

Usage

Setting::get('name', 'Computer');
// get setting value with key 'name'
// return 'Computer' if the key does not exists

Setting::all();
// get all settings

Setting::lang('zh-TW')->get('name', 'Computer');
// get setting value with key and language

Setting::set('name', 'Computer');
// set setting value by key

Setting::lang('zh-TW')->set('name', 'Computer');
// set setting value by key and language

Setting::has('name');
// check the key exists, return boolean

Setting::lang('zh-TW')->has('name');
// check the key exists by language, return boolean

Setting::forget('name');
// delete the setting by key

Setting::lang('zh-TW')->forget('name');
// delete the setting by key and language

Dealing with array

Setting::get('item');
// return null;

Setting::set('item', ['USB' => '8G', 'RAM' => '4G']);
Setting::get('item');
// return array(
//     'USB' => '8G',
//     'RAM' => '4G',
// );

Setting::get('item.USB');
// return '8G';

Dealing with locale

By default language parameter are being resets every set or get calls. You could disable that and set your own long term language parameter forever using any route service provider or other method.

Setting::lang(App::getLocale())->langResetting(false);

laravel-settings's People

Contributors

Stargazers

Watchers

laravel-settings's Issues

Eloquent/PostgreSQL issue returning `id`

I needed to add this in order to make settings save

class EloquentStorage

protected $primaryKey = null; public $incrementing = false;

Queries are doubled

Hi all, I'm not sure if it is only me.

When i checked my debug bar I noticed the queries are doubled whenever I retrieve a settings.

Laravel 6 array_get() failure

Since Laravel 6 array_get() is deprecated. Now Arr::get() is actual.

Unable to use settings in scheduled task

I want to use the settings in my scheduled tasks but I'm unable to get it working. Shouldn't I use the facade in this instance?

Non-static method Unisharp\Setting\Setting::get() should not be called statically

I am getting the above error when try to access the get method via Settings object.

Setting::get('key');

Dot.Notation name as key & default value for get()

Explanation:
If I have never called Setting::set('my.setting', true); and wanna retrieve value with default like this: Setting::get('my.setting', false);, that will return me not false as expected, but null.
Issue goes away if I stop using dot.notation for key name and default value works as a charm.
Examples:
Setting::get('my_setting', false); - gives me false as default if there is no mysetting
Setting::get('my.setting', false); - gives me null as default if there is no mysetting, but hey WTF?

ToDo : Get config file value if doesn't exist in Setting

Hi,

Thank so much for this nice package,
I've a suggestion :
It's a good idea to add a function that retrieves a value from a file config when it doesn't exist in Setting table,
Example:
$value = Setting::get('file.name'); // It returns config('file.name').

Thanks :)

I'm using Laravel 5.4.