rstgroup/zf-local-config-module

Module responsible for adding custom config.

ZF Local Config Module

This module allows you to dynamically adjust configuration of your application via command-line interface., _(*1)

Installation

Require module with Composer:, _(*2)

composer require rstgroup/zf-local-config-module

The next step is adding module to ZF system configuration (config/application.config.php):, _(*3)

return [
    'modules' => [
        (...),
        'RstGroup\ZfLocalConfigModule',
    ],
    (...)
]

... and providing the required configuration in your application's config:, _(*4)

return [
    'rst_group' => [
        'local_config' => [
            'filename' => 'config/autoload/dynamic-config.local.php'
        ],
    ],
];

Usage

The module provides command-line commands to help managing local, dynamically generated, application configuration., _(*5)

Setting configuration

Setting configuration is as simple as writing the line:, _(*6)

php public/index.php local-config set path.to.value string-value

This will result in writing the code into config/autoload/dynamic-config.local.php file:, _(*7)

return [
    'path' => [
        'to' => [
            'value' => 'string-value'
        ],
    ],
];

By default, all values passed via command line are treated as strings. To set value of any simple type, you can use JSON notation. To enable it, just add --json flag., _(*8)

Look at some of the examples below:, _(*9)

# setting a number
php public/index.php local-config set path.to.value 1234 --json
# setting null
php public/index.php local-config set path.to.value null --json

JSON notation can also be used to set a structure or an array in given path:, _(*10)

# setting an array
php public/index.php local-config set array "[1,2,3,4]" --json
# setting complex structure
php public/index.php local-config set structure '{"complex":{"structure":{"x":"y"},"x":null}}' --json

The result of these two commands ran one after another would be a config/autoload/dynamic-config.local.php file like:, _(*11)

return [
    'array' => [ 1, 2, 3, 4 ],
    'complex' => [
        'structure' => [
            'x' => 'y'
        ],
        'x' => null,
    ],
];