ed-smartass/yii2-settings

Dynamic setting for Yii2 application

1.0.2 2022-08-25 19:12 UTC

Requires

• yiisoft/yii2: ~2.0.14

MIT

• ed-smartass

• Settings
• yii2
• yii2 settings

README

Installation

1. Install via composer

composer require ed-smartass/yii2-settings

1. Apply migrations

php yii migrate --migrationPath=@vendor/ed-smartass/yii2-settings/src/migrations

Or add to console config

return [
    // ...
    'controllerMap' => [
        // ...
        'migrate' => [
            'class' => 'yii\console\controllers\MigrateController',
            'migrationPath' => [
                '@console/migrations', // Default migration folder
                '@vendor/ed-smartass/yii2-settings/src/migrations'
            ]
        ]
        // ...
    ]
    // ...
];

1. Config application

return [
    // ...
    'bootstrap' => [
        // ...
        'settings'
    ],
    'components' => [
        // ...
        'settings' => [
            'class' => 'Smartass\Yii2Settings\Settings',

            // Name of table with settings. Default: `{{%setting}}`.
            'table' => '{{%setting}}',

            // ID of db commponent in application. Default: `db`. 
            'dbComponent' => 'db',

            // If you want to cache setting. Default: `false`.
            'cache' => true, 

            // ID of cache commponent in application. Default: `cache`.
            'cacheComponent' => 'cache', 

            // Key for storing settings in cache. Default: `settings`.
            'cacheKey' => 'settings', 

            // Cache duration for settings. Default: `null`.
            'cacheDuration' => null, 

            // If you want to change Application config set to `true`
            // and set value at config like `'language' => '%main.language|ru%'`.
            // Where: `main.language` is setting name and `ru` is default value
            // Default: `false`.
            'processConfig' => false, 
        ]
    ]
    // ...
];

Usage

// List all settings
Yii::$app->settings->settings

// Get setting
Yii::$app->settings->get('access_token_ttl');
// Or
Yii::$app->settings->access_token_ttl;

// Set setting
Yii::$app->settings->set('access_token_ttl', 3600*24*7);
// Or
Yii::$app->settings->access_token_ttl = 3600*24*7; // Only if setting `access_token_ttl` already exist

Methods

• get($key, $default = null, $saveDefault = false) — get setting by key

  • $key — key of setting
  • $default — default value if setting does not exist
  • $saveDefault — save default value if setting does not exist

• set($key, $value, $type = null) — set setting

  • $key — key of setting
  • $value — value of setting (if value is null setting will be deleted)
  • $type — type of setting (integer, float, string, boolean, array), if type is null when type will be auto detected

• delete($key) — delete setting by key

  • $key — key of setting

• flush() — deleting all settings