raphhh / puppy-config
Config manager
Requires
- php: >=5.5.9
- symfony/yaml: ^3.0
Requires (Dev)
- phpunit/phpunit: @stable
This package is auto-updated.
Last update: 2024-11-25 22:14:04 UTC
README
Puppy Config is a config manager that loads your config from files according to your env.
Config basic logic:
- env config management (dev, test, prod, ...)
- multi file formats support (php, ini, json, yaml)
- dynamic config values
- visibility restriction
Installation
Run composer:
$ composer require raphhh/puppy-config
Read your config
Add the main config file /config/global.php:
// /config/global.php return [ 'key' => 'value', ];
Launch the Config class:
use Puppy\Config\Config; $config = new Config(); $config['key']; //'value'
Dynamic values
You can retrieve dynamically a previous defined value with it key.
// /config/global.php return [ 'key1' => 'value1', 'key2' => '%key1%_b', ];
use Puppy\Config\Config; $config = new Config(); $config['key2']; //'value1_b'
Set new values
You can set new values on the fly, which will be available in the Config object during all the script (and not saved into a file config).
use Puppy\Config\Config; $config = new Config(); $config['new_key'] = 'new_value';
You can also use the dynamic mapping.
$config['new_key2'] = '%new_key%'; $config['new_key2']; //'new_value'
Visibility restriction
You can determine some namespaces in your config, and restrict the visibility of each namespace.
For example, imagine you set this config, with two namespaces: 'a' and 'b'.
//namespace a $globalConfig['a.a'] = 'a.a'; $globalConfig['a.b'] = 'a.b'; //namespace b $globalConfig['b.a'] = 'b.a'; $globalConfig['b.b'] = 'b.b';
With the global scope config you can access to all the values.
$globalConfig['a.a']; //'a.a' $globalConfig['b.a']; //'b.a'
Now, restrict the config to the namespace 'a':
$restrictedConfig = $globalConfig->restrict('a');
With this restricted scope config, you can only have access to the namespace 'a' values:
$restrictedConfig['a']; //'a.a' $restrictedConfig['b']; //'a.b'
The original keys are not visible anymore:
isset($restrictedConfig['a.a']); //false isset($restrictedConfig['b.a']); //false
But, the global scope config is still bound to your restricted scope. So, if you modify one, you modify the other.
$restrictedConfig['a'] = 'new value'; $globalConfig['a.a']; //'new value'
Files format
By default, Config load 'php' files. This kind of file must return a PHP array.
// /config/global.php return [ 'key' => 'value', ];
But you can specify or add specific file formats.
new Config('', null, new YmlFileReader()); //will load config/global.yml
Available formats:
- php (default)
- ini
- json
- yaml
Multi environment
Your config is the merge of the values coming from three kind of files:
When is loaded the global config?
In all the cases, Config will load the file 'global.php'. (You can easily change this default file.)
By default, this is your prod config.
When is loaded the env config?
If you specify an env in the constructor, it will load also the associated file.
For example:
new Config('dev'); //will load dev.php (in addition to global.php)
The env config will override the global config. So, use it for your dev env, which will override your prod params.
How env can change dynamically?
Set an environment variable in your server virtual host configuration, and retrieve it with the php getenv() method.
In your httpd.conf or a .htaccess file of your dev Apache server, put:
SetEnv APP_ENV "dev"
In your PHP file, retrieve the env:
new Config(getenv('APP_ENV')); //will load dev.php only in your dev server
What is the local config?
The config will load also a local config, if the file config/local.php exists.
This config will override the global and the env configs. Be careful: this file must be NOT versioned.
So, it is an individual config, where your can put temporary or specific config. Your can also put config you do not want to version, like the passwords.