italystrap/config

ItalyStrap configuration class for easily config object

ItalyStrap Config API

, _(*1)

ItalyStrap Config Module - a simple and useful configuration package the OOP way, _(*2)

Table Of Contents

• Installation
• Basic Usage
• Advanced Usage
• Contributing
• License

Installation

The best way to use this package is through Composer:, _(*3)

composer require italystrap/config

Documentation

• Overview
• Traversing Data

Deprecation

List of all deprecated method that will be removed in the next major release (v3.x):, _(*4)

• Config::push() => Config::set()
• Config::add() => Config::set()
• Config::remove() => Config::delete()
• Config::all() => Config::toArray()
• Config::toJson() => (string)\json_encode(new Config(), JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
• ConfigThemeMods::class => No replacement class is provided
• ConfigThemeModTest::class => No replacement class is provided
• Config_Factory::class => ConfigFactory::class
• Config_Interface::class => ConfigInterface::class
• Move \JsonSerializable at the ConfigInterface::class level
• The second parameter of Config::__construct() is deprecated and will be removed in the next major release, the first parameter is now the default value used for the configuration, to add additional configuration you can use the Config::merge() method like in the example below:

$defaultData = [
    'key'   => 'value',
];

$additionalData = [
    'key'   => 'new value',
];

$config = (new Config($defaultData))->merge($additionalData);

• The static method ConfigFactory::make() will be converted to a non-static, so you will need to instantiate the class to use it, like in the example below:

$config = new ConfigFactory();
$config->make($data);

Contributing

All feedback / bug reports / pull requests are welcome., _(*5)

License

Copyright (c) 2019 Enea Overclokk, ItalyStrap, _(*6)

This code is licensed under the MIT., _(*7)

Credits

Ideas for the Config::class from: - Tonya Mork - Alain Schlesser, _(*8)

For the Notation Array Search: - https://github.com/balambasik/input/blob/master/src/Input.php, _(*9)

For the traverse method: - Nikita Popov, _(*10)

For some ideas: - ChatGPT, _(*11)