emaphp/fluent-configuration

A fluent configuration trait for PHP

fluent-configuration

A fluent configuration trait for PHP, _(*1)

, _(*2)

br/, _(*3)

Changelog

2014-02-23 * Modified: Method 'append' renamed to push. * Added: Method 'pop'., _(*4)

br/, _(*5)

Installation

composer.json, _(*6)

{
    "require": {
        "emaphp/fluent-configuration": "1.2.*"
    }
}

br/, _(*7)

Usage

br/ Include trait, _(*8)

namespace Demo;

class ConfigurationContainer {
    use \FluentConfiguration;
}

br/ Examples, _(*9)

use Demo\ConfigurationContainer;

$config = new ConfigurationContainer();

//set option
$config->setOption('test1', 'value1');
$option = $config->getOption('test1'); // 'value1'

//fluent interface
$newInstance = $config->option('test2', 'value2')->option('test3', 'value3');
$newInstance->getOption('test2'); // 'value2'
$config->hasOption('test2'); //false
$config->hasOption('test3'); //false

//merge options
$config = $newInstance->merge(['test3' => 'new_value', 'test4' => 'value4']);
$config->getOption('test1'); // 'value1'
$config->getOption('test3'); // 'new_value'
$config->getOption('test4'); // 'value4'
$newInstance->hasOption('test4'); // false

//discard
$config = $config->discard('test1', 'test3');
$config->hasOption('test1'); // false
$config->hasOption('test3'); // false
$config->hasOption('test4'); // true

//push & pop
$config = new ConfigurationContainer();
$config->setOption('list', 'item1');
$config = $config->push('list', 'item2', 'item3');
$config->getOption('list'); // ['item1', 'item2', 'item3']
$value = $config->pop('list'); // 'item3'

//preserve instance
$config = new ConfigurationContainer();
$config->preserveInstance = true;
$config->setOption('test1', 'val1');
$newConf = $config->option('test2', 'val2');
$config->hasOption('test1'); // true
$config->hasOption('test2'); // true
$newConf->getOption('test2') == $config->getOption('test2'); // true

br/, _(*10)

License

Released under the MIT license., _(*11)