Manage multiple configuration resources like a pro!

This package help you to manage configurations of various format and source and into one unified configuration collection.

This package is already part of Peak Framework but can be also used as standalone:

$ composer require peak/config

Load multiple config resources at once

ConfigFactory is the most easiest and direct way to access to all you configuration resources.

$configFactory = new ConfigFactory();
$config = $configFactory->loadResources([

All configurations are merged into one. Existing configuration keys are overwritten by later definitions: Example:

Method loadResources() accept an array of resources and return an instance of Peak\Config\Config. It support types:

Loading and processing data with Stream.

Under the hood, ConfigFactory will determine the best way to load and process your config by using Stream underneath. You can also be specific by pushing a stream to ConfigFactory::loadResource.

$configFactory = new ConfigFactory();
$config = $configFactory->loadResources([
    new JsonStream('{"foo": "bar"}'),
    new DataStream(["foo" => "bar2"], new ArrayProcessor()) // same as JsonStream
    new FileStream('myfile.json', new FileHandlers()),
    // ...    

Loaders are mean to handle how we retrieve the configuration content which is useful when comes to files. Peak\Config comes with 3 loaders that handle most common cases:

Processors are mean to handle how to process configuration data to an array. Peak\Config comes with 6 processors:

Stream are simply wrapper around loaders and processors. They are used internally by ConfigFactory to load resources correctly.

You can also create your own and/or used them directly load anything to an array:

$dataStream = new DataStream('custom content', new MyCustomProcessor());
$array = $dataStream->get();

Adding or changing a file handlers

FileHandlers determine how to load and process a file based on its extension.

For example a php file will use the PhpLoader and the ArrayProcessor.

You can add/override file handlers easily with by passing definitions to the constructor or via method set()

// create a file handlers and add a new handler (if handler already exists, it will be overrided)
$fileHandlers = new FileHandlers();

// and finally, tell the configuration factory to use your fileHandlers 
$configFactory = new ConfigFactory();
$config = $configFactory->loadResources([

Caching complex configuration

Processing complex multiple configurations can be costly and if they rarely change, you might want to cache the result instead.

Using ConfigCacheFactory is the most easy way to handle configuration cache the same way you use ConfigFactory:

$ccFactory = new ConfigCacheFactory(
    new ConfigFactory(),
    new FileCache(__DIR__)

// load resources or load a cache version of processed configurations
$config = $ccFactory->loadResources('my-conf-id', 3600, [

Or manually with ConfigCache and ConfigFactory:

$configCache = new FileCache('/path/to/cache');

$cacheId = 'my-configuration-id';

if ($configCache->isExpired($cacheId)) {
    $configFactory = new ConfigFactory();
    $config = $configFactory->loadResources([
        3600 // ttl in seconds
} else {
    $config = $configCache->get($cacheId);