phlib/console-configuration

Console Configuration Helper implementation.

2.0.1 2023-10-15 07:25 UTC

This package is auto-updated.

Last update: 2024-07-01 00:14:13 UTC


README

phlib/console-configuration

Code Checks Codecov Latest Stable Version Total Downloads Licence

Console Configuration Helper implementation.

Install

Via Composer

$ composer require phlib/console-configuration

Configuration Helper

Adds the -c path/to/config.php parameter to the console application and makes it easily accessible to all commands. This is most useful for third party libraries which rely on the configuration being specified from the options.

Basic Usage

// your usual cli setup script

use Phlib\ConsoleConfiguration\Helper\ConfigurationHelper;

$app = new Application('my-cli');
$app->setCommands(['...']);
$helper = ConfigurationHelper::initHelper(
    $app,
    $default = ['host' => 'localhost'],
    $options = []
);
$app->run();
class MyCommand extends Command
{
    '...'

    protected function createMyObjectInstance()
    {
        $config = $this->getHelper('configuration')->fetch();
        return new MyObjectInstance($config);
    }
}

Options

You can specify some options to setup the helper through the initHelper static method.

Name Type Default Description
name String 'config' The name of the option on the command line.
abbreviation String 'c' The abbreviation of the option on the command line.
description String '...' The associated description for the option.
filename String 'cli-config.php' The filename that will be detected if no name is specified.
ConfigurationHelper::initHelper($app, null, [
    'name' => 'config-option',
    'filename' => 'my-cli-config.php',
]);

Defaults

With no default (null) specified, the fetch method returns false. You can specify a default configuration using the setDefault method or through the initHelper static method.

$helper->setDefault(['host' => 'localhost']);

OR

ConfigurationHelper::initHelper(
    $app,
    ['host' => 'localhost'],
    ['filename' => 'service-name.php']
);

Use Case: Autodetect with no command line option

$app = new Application('my-cli');
$app->setCommands(['...']);
$app->getHelperSet()->set(new ConfigurationHelper('config', 'my-config.php'));
$app->run();

License

This package is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program. If not, see http://www.gnu.org/licenses/.