JSON.md

Usage

Set up a primary JSON (system.json, main.json, monkey.json or what ever you want to call it).

{
    "service" : "CrazyWebApp",
    "env"     : "dev",
    "conf"    : [
        "webapp",
        "dev",
        "ellisgl"
    ]
}

The importan key is conf, this tells the loader which JSON files to load up, and this is put in order, since we are merging/combining/replacing stuff from the previous imports.

Set up your secondary JSONs (E.g. webapp.json, dev.json, elllisgl.json, etc...). See /tests/_data/JSON for examples.

note: While you can use spaces and periods in sections / properties, just remember that spaces and periods will be transformed into underscores _.

You'd probably want these in another directory, like /conf. also don't forget to add conf/*.json to your .gitignore, since you really don't want your configurations out there in wild!

You might notice something in the dev.json, @[%database.host] and @[database.db%].

These are self referenced placeholders. When the configuration is being compiled, the last step is to replace those placeholders with something from with in the configuration. @[data.host] would be filled with localhost and {%database.db] would be replaced with ellisgldb, since the last JSON ellisgl.json imported had database -> db set to ellisgldb it overwrote the value that came from dev.json.

Also in the ellisgl.json, there is a $[DB_CHARSET] placeholder which will be replaced by the contents of the environmental variable DB_CHARSET.

You can also do a recursive self referenced placeholder replacement. If you look at the ellisgl.json, you might notice "a": "@[selfreferencedplaceholder.@[somestuff.a]]" which would become @[selfreferencedplaceholder.x] and then finally become We Can Do That!.

The next thing is to actually use it. So in your bootstrap.php, index.php, or what ever you load up first:

<?php
require_once('/path/to/your/vendor/autoload.php');

use GeekLab\Conf\GLConf;
use GeekLab\Conf\Driver\JSONConfDriver;

// Main JSON file.
$systemFile = '/path/to/your/main-system-monkey.json';

// Where configuration INIs are.
$confDir = '/path/to/your/jsons/';

// Start 'er up!
$conf = new GLConf(new JSONConfDriver($systemFile, $confDir));
$conf->init();

// Do some things.
define('IS_DEV', ($conf->get('ENV') === 'dev') ? true : false);
$db = new PDO($conf->get('database.dsn'), $conf->get('database.user'), $conf->get('database.pass'));

So for $conf->get(), it uses dot notation to access the data, and everything is case-insensitive. Also, there is a getAll() method, which will return an array of the compiled config.