webiny/config

Webiny Config Component

Config Component

Config component creates ConfigObject instances from config files. Currently supported formats: INI, JSON, PHP, YAML and custom drivers., _(*1)

Install the component

The best way to install the component is using Composer., _(*2)

composer require webiny/config

For additional versions of the package, visit the Packagist page., _(*3)

Usage

To use Config component you will need a config file., _(*4)

Example INI:, _(*5)

[properties]
a = "value"
b.name = "name"
b.value = "value"

Here is an example of creating a ConfigObject:, _(*6)

    $config = \Webiny\Components\Config\Config::getInstance()->ini('path/to/file.ini');

This will result in $config object containing the following properties:, _(*7)

    $config->properties->a = 'value';
    $config->properties->b->name = 'name';
    $config->properties->b->value = 'value';

If you don't want to use INI sections, or set custom nest delimiter, specify the following arguments:, _(*8)

    $config = \Webiny\Components\Config\Config::getInstance()->ini('path/to/file.ini', false, '_');

You can get your config as string in any format using the following methods:, _(*9)

    $string = $config->getAsJson();
    $string = $config->getAsPhp();
    $string = $config->getAsIni($useSections = true, $nestDelimiter = '.');
    $string = $config->getAsYaml($indent = 4);

And you can also use custom driver, _(*10)

    $driverInstance = new MyCustomDriver();
    $string = $config->getAs($driverInstance);

You can also merge one config with another ConfigObject or array:, _(*11)

$config->mergeWith($config2);

Resources

To run unit tests, you need to use the following command:, _(*12)

$ cd path/to/Webiny/Component/Config/
$ composer.phar install
$ phpunit