icanboogie / config
Synthesizes low-level configurations.
Installs: 3 975
Dependents: 1
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Requires
- php: >=5.5
- icanboogie/common: ^1.2|^2.0
- icanboogie/storage: ^2.0|^3.0
README
An API to build low-level configuration.
This package is used by the framework ICanBoogie to configure its components.
Configurations are defined by a set of files called fragments. Builders use these fragments to build configurations. Configurations are managed by a [Config][] instance. Configurations can be cached, which cancels the cost of the builds.
Installation
composer require icanboogie/config
Configuration fragments
A configuration fragment is a PHP file returning a callable. Multiple fragments are used to build a configuration. They're usually located in "config" directories and are usually named after the config they are used to build.
Configuration provider
Configurations are read through a ConfigProvider.
The following example demonstrates how to get a configuration of class MyConfig
:
<?php /* @var \ICanBoogie\ConfigProvider\BasicConfigProvider $config */ $my_config = $config->config_for_class(MyConfig::class);
A NoBuilderDefined exception is thrown if there is no builder defined for a configuration class.
Configuration builders
Builders are defined for each configuration.
<?php use ICanBoogie\ConfigProvider\BasicConfigProvider; /* @var string[] $paths */ $builders = [ MyConfig::class => MyBuilder::class ]; $config = new BasicConfigProvider($paths, builders); $my_config = $config->config_for_class(MyConfig::class);
Caching configurations
Caching configurations removes the cost of building by reusing the result of a previous build. To enable caching, you just need to provide a cache implementing Storage.
<?php namespace ICanBoogie; use ICanBoogie\ConfigProvider\BasicConfigProvider; $config = new BasicConfigProvider($paths, $builders, $cache);
Continuous Integration
The project is continuously tested by GitHub actions.
Code of Conduct
This project adheres to a Contributor Code of Conduct. By participating in this project and its community, you're expected to uphold this code.
Contributing
Please see CONTRIBUTING for details.