allow Config::set to set an entire configuation array.

This commit is contained in:
Taylor Otwell 2011-08-14 14:08:04 -05:00
parent 9f1edfaee3
commit 57922c5a4d
1 changed files with 24 additions and 4 deletions

View File

@ -5,12 +5,14 @@ class Config {
/** /**
* All of the loaded configuration items. * All of the loaded configuration items.
* *
* The configuration item arrays are keyed by module and file.
*
* @var array * @var array
*/ */
public static $items = array(); public static $items = array();
/** /**
* Determine if a configuration item or file exists. * Determine if a configuration file or item exists.
* *
* @param string $key * @param string $key
* @return bool * @return bool
@ -30,6 +32,14 @@ public static function has($key)
* If the name of a configuration file is passed without specifying an item, the * If the name of a configuration file is passed without specifying an item, the
* entire configuration array will be returned. * entire configuration array will be returned.
* *
* <code>
* // Get the application timezone
* $timezone = Config::get('application.timezone');
*
* // Get the application configuration array
* $application = Config::get('application');
* </code>
*
* @param string $key * @param string $key
* @param string $default * @param string $default
* @return array * @return array
@ -51,6 +61,16 @@ public static function get($key, $default = null)
/** /**
* Set a configuration item. * Set a configuration item.
* *
* If a configuration item is not specified, the entire configuration array will be set.
*
* <code>
* // Set the application timezone
* Config::set('application.timezone', 'America/Chicago');
*
* // Set the application configuration array
* Config::set('application', array());
* </code>
*
* @param string $key * @param string $key
* @param mixed $value * @param mixed $value
* @return void * @return void
@ -59,16 +79,16 @@ public static function set($key, $value)
{ {
list($module, $file, $key) = static::parse($key); list($module, $file, $key) = static::parse($key);
if (is_null($key) or ! static::load($module, $file)) if ( ! static::load($module, $file))
{ {
throw new \Exception("Error setting configuration option. Option [$key] is not defined."); throw new \Exception("Error setting configuration option. Option [$key] is not defined.");
} }
static::$items[$module][$file][$key] = $value; (is_null($key)) ? static::$items[$module][$file] = $value : static::$items[$module][$file][$key] = $value;
} }
/** /**
* Parse a configuration key. * Parse a configuration key into its module, file, and key segments.
* *
* @param string $key * @param string $key
* @return array * @return array