reva2/config-service-provider

A config ServiceProvider for Silex 2.x with support for php, json and yaml.

ConfigServiceProvider

, _(*1)

A config ServiceProvider for Silex 2 with support for php, json, yaml, and toml., _(*2)

This is fork of igorw/config-service-provider., _(*3)

Usage

Passing a config file

Pass the config file's path to the service provider's constructor. This is the recommended way of doing it, allowing you to define multiple environments., _(*4)

$env = getenv('APP_ENV') ?: 'prod';
$app->register(new Igorw\Silex\ConfigServiceProvider(__DIR__."/../config/$env.json"));

Now you can specify a prod and a dev environment., _(*5)

config/prod.json, _(*6)

{
    "debug": false
}

config/dev.json, _(*7)

{
    "debug": true
}

To switch between them, just set the APP_ENV environment variable. In apache that would be:, _(*8)

SetEnv APP_ENV dev

Or in nginx with fcgi:, _(*9)

fastcgi_param APP_ENV dev

Replacements

Also, you can pass an array of replacement patterns as second argument., _(*10)

$app->register(new Igorw\Silex\ConfigServiceProvider(__DIR__."/../config/services.json", array(
    'data_path' => __DIR__.'/data',
)));

Now you can use the pattern in your configuration file., _(*11)

/config/services.json, _(*12)

{
    "xsl.path": "%data_path%/xsl"
}

You can also specify replacements inside the config file by using a key with %foo% notation:, _(*13)

{
    "%root_path%": "../..",
    "xsl.path": "%root_path%/xsl"
}

Using Yaml

To use Yaml instead of JSON, just pass a file that ends on .yml:, _(*14)

$app->register(new Igorw\Silex\ConfigServiceProvider(__DIR__."/../config/services.yml"));

Note, you will have to require the ~2.1 of the symfony/yaml package., _(*15)

Using TOML

To use TOML instead of any of the other supported formats, just pass a file that ends on .toml:, _(*16)

$app->register(new Igorw\Silex\ConfigServiceProvider(__DIR__."/../config/services.toml"));

Note, you will have to require the ~0.1 of the jamesmoss/toml package and you are using a bleeding edge configuration format, as the spec of TOML is still subject to change., _(*17)

Using plain PHP

If reading the config file on every request becomes a performance problem in production, you can use a plain PHP file instead, and it will get cached by APC., _(*18)

You'll have to rewrite your config to be a PHP file that returns the array of config data, and also make sure it ends with .php:, _(*19)

$app->register(new Igorw\Silex\ConfigServiceProvider(__DIR__."/../config/prod.php"));

Multiple config files

You can use multiple config files, e. g. one for a whole application and a specific one for a task by calling $app->register() several times, each time passing another instance of Igorw\Silex\ConfigServiceProvider., _(*20)

Register order

Make sure you register ConfigServiceProvider last with your application. If you do not do this, the default values of other Providers will override your configuration., _(*21)