Skip to main content

Loading the configuration

After setup the configuration files, you need to load them into the container.

Create the environment definition​

The definition will specify how the configuration will be loaded, what environments will be available and the inheritance between them.

<?php
$dev = new \ByJG\Config\Environment('dev');
$prod = new \ByJG\Config\Environment('prod', ['dev'], $somePsr16Implementation);

$definition = (new \ByJG\Config\Definition())
    ->withConfigVar('APP_ENV')     // Setup the environment var used to auto select the config. 'APP_ENV' is default.
    ->addEnvironment($dev)             // Defining the 'dev' environment
    ->addEnvironment($prod)            // Defining the `prod` environment that inherits from `dev`
;

The Environment constructor has the following parameters:

<?php
new \ByJG\Config\Environment(
    string $environment,                              // The environment name
    array $inheritFrom = [],                          // The list of environments to inherit from
    \Psr\SimpleCache\CacheInterface $cache = null,    // The PSR-16 implementation to cache the configuration
    bool $abstract = false                            // If true, the environment will not be used to load the configuration
    bool $final = false                               // If true, the environment cannot be used to inherit from
);

Build the definition​

<?php
// This will check the config var 'APP_ENV' and load the configuration from the file config-<APP_ENV>.php and config-<APP_ENV>.env and create the instance `$container`
$container = $definition->build();

If APP_ENV is not set or it values doesn't exist at least one of the files config-<APP_ENV>.php or config-<APP_ENV>.env and error will be thrown.

Get the Values from the container​

After build the definition you can get the values from the container:

<?php
$property = $container->get('property1');

If value is a closure, it will return the closure execution result:

<?php
// Get the closure execution result:
$property = $container->get('property3');

// Get the closure execution result with the arguments 1 and 2:
$property = $container->get('propertyWithArgs', 1, 2);

Also, it is possible to get raw value without any parse:

<?php
$property = $container->raw('property3');

Get the configuration set is active​

<?php
$definition->getCurrentEnvironment();

Open source ByJG