1 files changed, 101 insertions, 0 deletions
diff --git a/framework/collections/CConfiguration.php b/framework/collections/CConfiguration.php
new file mode 100644
index 0000000..eaa427b
--- /dev/null
+++ b/framework/collections/CConfiguration.php
@@ -0,0 +1,101 @@
+<?php
+/**
+ * This file contains classes implementing configuration feature.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright &copy; 2008-2011 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+
+/**
+ * CConfiguration represents an array-based configuration.
+ *
+ * It can be used to initialize an object's properties.
+ *
+ * The configuration data may be obtained from a PHP script. For example,
+ * <pre>
+ * return array(
+ *     'name'=>'My Application',
+ *     'defaultController'=>'index',
+ * );
+ * </pre>
+ * Use the following code to load the above configuration data:
+ * <pre>
+ * $config=new CConfiguration('path/to/config.php');
+ * </pre>
+ *
+ * To apply the configuration to an object, call {@link applyTo()}.
+ * Each (key,value) pair in the configuration data is applied
+ * to the object like: $object->$key=$value.
+ *
+ * Since CConfiguration extends from {@link CMap}, it can be
+ * used like an associative array. See {@link CMap} for more details.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @version $Id: CConfiguration.php 3458 2011-11-21 02:13:03Z alexander.makarow $
+ * @package system.collections
+ * @since 1.0
+ */
+class CConfiguration extends CMap
+{
+	/**
+	 * Constructor.
+	 * @param mixed $data if string, it represents a config file (a PHP script returning the configuration as an array);
+	 * If array, it is config data.
+	 */
+	public function __construct($data=null)
+	{
+		if(is_string($data))
+			parent::__construct(require($data));
+		else
+			parent::__construct($data);
+	}
+
+	/**
+	 * Loads configuration data from a file and merges it with the existing configuration.
+	 *
+	 * A config file must be a PHP script returning a configuration array (like the following)
+	 * <pre>
+	 * return array
+	 * (
+	 *     'name'=>'My Application',
+	 *     'defaultController'=>'index',
+	 * );
+	 * </pre>
+	 *
+	 * @param string $configFile configuration file path (if using relative path, be aware of what is the current path)
+	 * @see mergeWith
+	 */
+	public function loadFromFile($configFile)
+	{
+		$data=require($configFile);
+		if($this->getCount()>0)
+			$this->mergeWith($data);
+		else
+			$this->copyFrom($data);
+	}
+
+	/**
+	 * Saves the configuration into a string.
+	 * The string is a valid PHP expression representing the configuration data as an array.
+	 * @return string the string representation of the configuration
+	 */
+	public function saveAsString()
+	{
+		return str_replace("\r",'',var_export($this->toArray(),true));
+	}
+
+	/**
+	 * Applies the configuration to an object.
+	 * Each (key,value) pair in the configuration data is applied
+	 * to the object like: $object->$key=$value.
+	 * @param object $object object to be applied with this configuration
+	 */
+	public function applyTo($object)
+	{
+		foreach($this->toArray() as $key=>$value)
+			$object->$key=$value;
+	}
+}