README

Setting for laravel

This is a package for a dynamic setting across different Laravel projects.

Install via composer

Run the following command to pull in the latest version:

composer require jobmetric/laravel-setting

Documentation

To use the services of this package, please follow the instructions below.

Migrate the database

Run the following command to migrate the database:

php artisan migrate

Usage

Dispatch setting into the database

The dispatch method will create a new setting if it does not exist, otherwise it will update the existing setting.

use JobMetric\Setting\Facades\Setting as SettingFacade;

SettingFacade::dispatch('config', [
    'config_name' => 'job metric',
    'config_url' => 'jobmetric.net',
    'config_address' => [
        'city' => 'Mashhad',
        'street' => 'Pastor',
        'postal_code' => '1234567890',
    ],
]);

The first parameter is the setting key, and the second parameter is an array of key-value pairs.

Since event is an extraneous task, it is not useful in this method, this value is optionally placed in the third parameter, so that if your program needs it, it can be set.

The data array keys must start with config_ which is the same code, otherwise the storage will not be done.

Key-value pairs are stored in the settings table on a record-by-record basis.

The value of the keys can be an array or string or boolean or integer or float.

When the settings are updated, the settings caches are cleared, and if each user executes a new request on the server, the system cache is rebuilt.

Get setting

The get method will return the value of the setting key.

use JobMetric\Setting\Facades\Setting as SettingFacade;

$config_name = SettingFacade::get('config_name');

The first parameter is the setting key.

The second parameter is the default value of the setting key. If the setting key does not exist, the default value will be returned.

The get method will return the value of the setting key.

Get all settings

The all method will return all settings.

use JobMetric\Setting\Facades\Setting as SettingFacade;

$settings = SettingFacade::all();

Forget setting

The forget method will delete the setting code.

use JobMetric\Setting\Facades\Setting as SettingFacade;

SettingFacade::forget('config');

The first parameter is the setting code.

Has setting

The has method will return true if the setting code exists, otherwise it will return false.

use JobMetric\Setting\Facades\Setting as SettingFacade;

$has = SettingFacade::has('config_name');

The first parameter is the setting key.

The has method will return true if the setting code exists, otherwise it will return false.

Helper functions

Dispatch setting

The setting helper function will create a new setting if it does not exist, otherwise it will update the existing setting.

dispatchSetting('config', [
    'config_name' => 'job metric',
    'config_url' => 'jobmetric.net',
    'config_address' => [
        'city' => 'Mashhad',
        'street' => 'Pastor',
        'postal_code' => '1234567890',
    ],
]);

Forget setting

The forgetSetting helper function will delete the setting code.

forgetSetting('config');

Get setting

The getSetting helper function will return the value of the setting key.

$config_name = getSetting('config_name');

Code settings

All the values set in the code form are returned.

$settings = codeSettings('config');

Has setting

The hasSetting helper function will return true if the setting code exists, otherwise it will return false.

$has = hasSetting('config_name');

License

The MIT License (MIT). Please see License File for more information.