Download the PHP package yii2tech/config without Composer
On this page you can find all versions of the php package yii2tech/config. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package config
Application Runtime Configuration Extension for Yii 2
This extension provides support for application runtime configuration, loading config from database.
For license information check the LICENSE-file.
Installation
The preferred way to install this extension is through composer.
Either run
or add
to the require section of your composer.json.
Usage
This extension allows reconfigure already created Yii application instance using config composed from external storage like relational database, MongoDB and so on. It allows to reconfigure any application property, component or module. Configuration is performed by [[\yii2tech\config\Manager]] component, which should be added to the application configuration. For example:
[[\yii2tech\config\Manager]] implements [[\yii\base\BootstrapInterface]] interface, thus being placed under 'bootstrap' section it will apply runtime configuration during application bootstrap. You can apply config manually to the application or any [[\yii\base\Module]] descendant, using following code:
Configuration items specification
Application parts, which should be reconfigured are determined by [[\yii2tech\config\Manager::$items]], which is a list
of [[\yii2tech\config\Item]]. Each configuration item determines the configuration path - a list of keys in application
configuration array, which leads to the target value. For example: path 'components.formatter.nullDisplay' (or
['components', 'formatter', 'nullDisplay']
) points to the property 'nullDisplay' of [[\yii\i18n\Formatter]] component,
path 'name' points to [[\yii\base\Application::name]] and so on.
Note: if no path is specified it will be considered as a key inside [[\yii\base\Module::$params]] array, which matches configuration item id (name of key in [[\yii2tech\config\Manager::$items]] array).
Configuration item may also have several properties, which supports creation of web interface for configuration setup. These are:
- 'label' - string, input label.
- 'description' - string, configuration parameter description or input hint.
- 'rules' - array, value validation rules.
- 'inputOptions' - array, list of any other input options.
Here are some examples of item specifications:
Tip: since runtime configuration may consist of many items and their declaration may cost a lot of code, it can be moved into a separated file and specified by this file name.
Configuration storage
Declared configuration items may be saved into persistent storage and then retrieved from it. The actual item storage is determined via [[\yii2tech\config\Manager::storage]].
Following storages are available:
- [[\yii2tech\config\StoragePhp]] - stores configuration inside PHP files
- [[\yii2tech\config\StorageDb]] - stores configuration inside relational database
- [[\yii2tech\config\StorageMongoDb]] - stores configuration inside MongoDB
- [[\yii2tech\config\StorageActiveRecord]] - finds configuration using ActiveRecord
Please refer to the particular storage class for more details.
Creating configuration web interface
The most common use case for this extension is creating a web interface, which allows control of application configuration in runtime. [[\yii2tech\config\Manager]] serves not only for applying of the configuration - it also helps to create an interface for configuration editing.
The web controller for configuration management may look like following:
The main view file can be following:
Standalone configuration
[[\yii2tech\config\Manager]] can be used not only for application configuration storage: it may hold any abstract configuration set for any standalone task. You can configure manager as an application component, which stores some user settings as use it to retrieve it. For example:
php if (Yii::$app->userInterfaceConfig->getItemValue('sidebarEnabled')) { // render sidebar }
echo Yii::$app->userInterfaceConfig->getItemValue('backgroundColor');
Note that you should enable [[\yii2tech\config\Manager::$autoRestoreValues]] to make configuration values to be
restored from persistent storage automatically, otherwise you'll have to invoke [[\yii2tech\config\Manager::restoreValues()]]
method manually. Also do not forget to specify default value for each configuration item, otherwise it will be picked up
from current application.
You may also use [[\yii2tech\config\Manager]] to configure particular component. For example:
In above example fields `isEnabled` and `color` will always be configured from persistent storage.