1.8Documentation

Config Class

The Config class handles nearly all configuration options in Fuel. You use this class whenever you need to load in a config file, get a value or set a value.

Config File Types

• PHP. The default type. A PHP file should return an array structure.

   return array('key' => 'value');

• INI. See this page for a definition of the ini-file layout.

   [group]
  key=value

• YAML. See this page for a definition of the yaml-file layout.

   group:
     key: value

• JSON. See this page for a definition of the json-file layout.

   {
  "group" :
      {
          "key": "value"
      }
  }

• MEMCACHED. Stores or retrieves the config from a Memcached or Memcachedb store.
  
  It will use the config.memcached section of the app/config/config.php configuration file to configure the memcached class used to connect to the store.
  
  
• DB. Use the following table structure:

    CREATE TABLE IF NOT EXISTS `config` (
    `identifier` char(100) NOT NULL,
    `config` longtext NOT NULL,
    `hash` char(13) NOT NULL,
    PRIMARY KEY (`identifier`)
  )

  By default it will use the table name 'config', in the default database. You can override this by defining your database and table name in app/config/config.php, using the config.database and config.table_name key.

If you don't specify a file type, Config::load() will default to the 'php' type.

If you have more complex configuration values, you can opt to define them as a closure. By default, the closure is returned when you get() the config key, and evaluated at runtime, either by you calling it as a function, or wrapping it into Fuel::value() to get the closures result. If you don't want this behavior, but cache and re-use the result (for example because your closure always returns the same result), you have to wrap the closure into Fuel::value() in your config file where you define the closure.

The same is true if you want to pass a closure to the set() method. If you want to store the closures result and not the closure itself, you have to wrap the closure into Fuel::value() when passing it to the set() method.

Note that you can only define closures in config files of type "php".

Config Groups

A config group is simply a way to scope config options. This avoids naming collisions. All config files (db.php, routes.php, etc.) are loaded into groups of the same name, with the exception of the main config.php file.

Methods

// Outputs the current language set in config.php
echo Config::get('language');

// By default a non-existent item will return null
if (Config::get('items_to_display') === null)
{
    throw new Exception('You must set the number of items to display in config.php');
}

// You can set a default for non-existent items as well
$items_to_display = Config::get('items_to_display', 10);

// This will load in the entire db group, which is the contents of config/db.php
$db_configs = Config::get('db');

// This will get which db connection is set to 'active' in the db config
$active_db = Config::get('db.active');

// You can go multiple levels deep as well.
// This will fetch the hostname of the 'dev' db group
$dev_host = Config::get('db.dev.connection.hostname');

// Sets the current language
Config::set('language', 'en');

// Sets the active db connection
Config::set('db.active', 'test');

// This sets a custom value that you can use later
Config::set('items_to_display', 5);

// You can also use dots to create custom groups and items
Config::set('blog.items_to_display', 5);

// Remove a configuration item using dot notation
Config::delete('blog.items_to_display');

// This merges the "custom" config file in with the root config.
Config::load('custom');

// This loads the "custom" config file in a group named "custom".
Config::load('custom', true);

// This loads the "custom.ini" config file in a group named "custom".
Config::load('custom.ini', true);

// This loads the "custom" config file in a group named "foo".
Config::load('custom', 'foo');

// This loads the "custom" config from a module called foo in a group named "bar"
Config::load('foo::custom', 'bar');

// This loads the "custom" config file in a group named "foo".
Config::load('custom', 'foo');

// update some config item
Config::set('foo.key', $value);

// save the updated config group 'foo' (note: it will save everything in that group!)
Config::save('custom', 'foo');

// save the updated config group 'bar' to config file 'custom' in the module 'foo'
Config::save('foo::custom', 'bar');

// save the updated config group 'bar' to memcached using the identifier 'custom'
Config::save('custom.memcached', 'bar');