Array.md

Usage

Set up a primary Array file (system.php, main.php, monkey.php or what ever you want to call it).

<?php
return [
    'service' => 'CrazyWebApp',
    'env'     => 'dev',
    'conf'    => [
        'webapp',
        'dev',
        'ellisgl'
    ]
];

The important array key is conf, this tells the loader which Array (PHP) 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 Arrays (E.g. webapp.php, dev.php, elllisgl.php, etc...). See /tests/_data/Array 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/*.php to your .gitignore, since you really don't want your configurations out there in wild!

You might notice something in the dev.php, @[%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 Array ellisgl.php imported had database -> db set to ellisgldb it overwrote the value that came from dev.php.

Also in the ellisgl.php, 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.php, 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\ArrayConfDriver;

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

// Where configuration Arrays are.
$confDir = '/path/to/your/arrays/';

// Start 'er up!
$conf = new GLConf(new ArrayConfDriver($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.