config

config() is a file configuration loader that supports PHP, JSON and INI files. Files are parsed and loaded depending on the file's extension name.

example

Here's an example JSON file that we'll use as config.json.

{
  "app": {
    "host": "localhost",
    "port": 80,
    "base": "/my/app"
  },
  "security": {
    "secret": "s3cr3t-c0d3"
  },
  "debug": false
}

Here's the same config file in PHP format.

<?php
return array(
  'app' => array(
    'host' => 'localhost',
    'port' => 80,
    'base' => '/my/app'
  ),
  'security' => array(
    'secret' => 's3cr3t-c0d3'
  ),
  'debug' => false
);
?>

Or in a PHP file that returns a function that creates your config

<?php
return function () {
  // you can be creative with this, return settings
  // depending on some logic
  return array(
    'app' => array(
      'host' => 'localhost',
      'port' => 80,
      'base' => '/my/app'
    ),
    'security' => array(
      'secret' => 's3cr3t-c0d3'
    ),
    'debug' => false
  );
};
?>

Or in INI format.

debug = false

[app]
host = localhost
port = 80
base = /my/app

[security]
secret = s3cr3t-c0d3

Below's the code we'll use to work with any of these files. Just change the filename to the one you want to use.

<?php
// import class
use Noodlehaus\Config;

// load the config
$conf = Config::load('config.json');

// this also works
$conf = new Config('config.json');

// get the "debug" flag
$debug = $conf->get('debug');

// get the "secret" value under "security"
$secret = $conf->get('security.secret');

// try to get a value with a default as fallback
$ttl = $conf->get('app.timeout', 3000);

// get an entire config subarray
$app = $conf->get('app');

// set some values, creating nesting if necessary
$conf->set('database.host', 'localhost');
$conf->set('database.name', 'mydatabase');

// you can also do subarray assignment
$conf->set('database', array(
  'host' => 'localhost',
  'name' => 'mydatabase'
));
?>

license

MIT: http://noodlehaus.mit-license.org