README

A very simple, smart, light-weight and dynamic configuration manager for PHP.

Iconfig (Instant Config) could be used as a stand alone component to manage the configuration of any php application. It can load settings saved in a php file and build an array which would be available at run time. It provides useful methods to set or retrieve any configuration at the run time of an application.

Installation

Iconfig uses Composer to make things easy.

Learn to use composer and add this to require (in your composer.json):

"sheikhheera/iconfig": "1.0.0"

And run:

composer update

Library on Packagist.

How It Works ?

Basically, php applications or mvc frameworks use array for configurations, for example, this is a sample of database configuration

return array(
 	'default' => 'mysql',
	'connections' => array(
		'sqlite' => array(
			'driver'   => 'sqlite',
			'database' => 'public/caliber.sqlite',
			'prefix'   => 'cb_',
		),
		'mysql' => array(
			'driver'    => 'mysql',
			'host'      => 'localhost',
			'database'  => 'caliber',
			'username'  => 'root',
			'password'  => 'bossboss',
			'charset'   => 'utf8',
			'collation' => 'utf8_unicode_ci',
			'prefix'    => 'cb_',
		)
   ),
);

An mvc framework or an application without any framework must have some common settings and user can configure those according to his/her need and most often all configuration files reside in a single folder, commonly, the config name is used. So, keeping that on mind, this dynamic configuration manager (or whatever you say) has been built, which loads all files from a given path. For example :

Initialization

$config = new Iconfig\Config('config');

Above code will load all files from the config folder (it expects arrays inside files) and will put everything in an array (groups using file name). Now, you can set/get any item from the array. For example, if you want to get the default item from the array, then you can use

$default = $config->getDatabase('default'); // mysql

Now, what is getDatabase() ? Actually, in this example, I've used the file name database.php for this array so I can use getDatabase() and setDatabase() to get or set an item. If I have a file named with session.php then I can use getSession() and setSession() to get or set any settings for session management. Which means, when you will pass the path (where you all configuration files are saved) to the constructor it'l load all 'php' files from that path/folder. So If, for example, in a folder named settings you have three files inside that folder as database.php, session.php and for example chache.php and if you initialize it using

$settings = new Iconfig\Config('settings');

Then, it'll load all three php files from the folder and it'll create one associative array using three groups like

Array(
  'database' => array(
    'default' => 'mysql',
    'connections' => array(
		    'sqlite' => array(
			  'driver'   => 'sqlite',
			  'database' => 'public/caliber.sqlite',
			  'prefix'   => 'cb_',
		  )
  ),
  'session' => array(
    'driver' => 'native',
    'lifetime' 120,
    'files' => '/sessions'
  ),
  'chache' =>array(
    'path' => 'c:/web/app/storage'
  )
);

Now, you can use this array to retrieve a setting or you can also set/change any predefined settings using dynamic methods.

Dynamic Methods

You can use setDatabase() and getDatabase to set/get database' configurations and setSession() and getSession for session and so on. These dynamic methods will be available to you after initialization, using php's overloading technic.

$settings->setDatabase('default', 'sqlite');
$settings->getDatabase('default'); // sqlite

$settings->setSession('lifetime', 240);
$settings->getSession('lifetime'); // 240

Using Alias

If you want you can set an Alias and can use methods statically like this :

new Iconfig\Config('../myApp/config', 'Config'); // Config as Alias, you can use any name
if(Config::isExist('session')) {
    Config::setSession('driver', 'database');
    $sessionArray = Config::getSession(); // full array will be returned when called without argument
}

Give Default Value

Also you can use a defult value like

$chache = getChache('path', '/web') // if path doesn't exist then "/web" will be returned

Access Nested Arrays

If you have three database connections and all have a driver key then you can specify which driver key you want like

Config::getDatabase('connections.sqlite.driver'); // get the driver from sqlite
Config::getDatabase('connections.pgsql.driver'); // get the driver from pgsql

Use callbacks

You can use closure as getMethod($key, $callback)

$connections = Config::getDatabase('connections', function($data){
  if(is_array($data) && array_key_exists('sqlite', $data)) {
		Config::setDatabase('connections.sqlite.driver', 'myNewSqliteDriver');
		return Config::getDatabase('connections'); // this will return connections array with new value
	}
});

Same could be used when setting a value like setDatabase('connections.pgsql.driver', 'pgsql').

Search Using find() Method

You can also use ::find() to search for an item as

Config::find('sqlite'); // if it exists, you'll get the value
Config::find('connections.sqlite'); // it'll look sqlite in to the connections
Config::find('connections.sqlite.driver'); // it'll look driver in to the connections.sqlite array

Get All Using getAll() Method

Also you can use

$all = Config::getAll();
var_dump($all); // full configuration array will be returned

Load More Files Using load() Method

You can also use

Config::load('filePath'); // new items will be added.

Well, that's all for now. Feel free to use or modify it to improve it's functionality or if you find any bug, please inform me. Hope, I'll be able to add more features in future In-Sha-Allah (on God's will). Thanks!

© 2013 Sheikh Heera. Licensed under MIT.