README

pimple-env-provider is a super simple, Silex compatible, lightweight service provider to allow overriding of Pimple container parameters with the value of environment variables.

Install

> composer require e-artspace/pimple-env-provider

#Usage

The container's parameters allowed to be overridden must be declared in env.prefix array. Foreach parameter a cast service name must be supplied (custom or predefined).

Call 'env.overload' before using the container.

putenv('DEBUG_APP=false');

$container = new \Pimple\Container([
	'debug.app'=> true
]);

$container->register(new \EnvProvider\EnvProvider([
	'env.vars'=>[
		'debug.app'=>'env.cast.boolean'
	]
]);

assert($container['debug.app'] === true);

$container['env.overload']; // this do the magic

assert($container['debug.app'] === false);

Predefined services:

• env.cast.strval: cast to a string
• env.cast.intval: cast to a integer
• env.cast.json_decode: to an array from a json string
• env.cast.boolean: cast to boolean 'true','TRUE' oe '1' => true otherwhise false
• env.name.builder: function to generate environment variable name, by default: environment var name = strtoupper((str_replace('.', '_', container var name)));
• env.prefix: a prefix for generated environment variable name (default is empty)

Create a new cast service:

$container['env.cast.onoff'] = $app->protect(function($str) {
	return (0===strcasecmp('on',$str));
};

Customize env.name.builder service

$container['env.name.builder'] = app->protect(function($name) {
	return strtolower((str_replace('.', '-', $name)));;
})

Developing and Testing with docker

$ docker run --rm -ti -v $PWD/.:/app composer install
$ docker run --rm -ti -v $PWD/.:/app composer vendor/bin/phpunit

License

(c) Enrico Fagnoni MIT License (see file)