Massive amounts of documentation has been added.
git-svn-id: http://svn.cleancode.org/svn/pickles@55 4d10bc64-7434-11dc-a737-d2d0f8310089
This commit is contained in:
parent
cbcfc9cc4f
commit
1784514696
20 changed files with 941 additions and 59 deletions
|
@ -1,13 +1,45 @@
|
|||
<?php
|
||||
|
||||
/**
|
||||
* Configuration class
|
||||
*
|
||||
* Handles loading and caching of the configuration into a Singleton object.
|
||||
* Contains logic to determine if the configuration has already been loaded and
|
||||
* will opt to use a "frozen" object rather than instantiate a new one. Also
|
||||
* contains logic to reload configurations if the configuration file had been
|
||||
* modified since it was originally instantiated (smart caching).
|
||||
*
|
||||
* @package PICKLES
|
||||
* @author Joshua Sherman <josh@phpwithpickles.org>
|
||||
* @copyright 2007-2008 Joshua Sherman
|
||||
* @todo Add the ability to load in multiple configuration files.
|
||||
*/
|
||||
class Config extends Singleton {
|
||||
|
||||
/**
|
||||
* Private instance of the Config class
|
||||
*/
|
||||
private static $instance;
|
||||
|
||||
/**
|
||||
* Timestamp from when the object was frozen
|
||||
*/
|
||||
public $timestamp = null;
|
||||
|
||||
/**
|
||||
* Private constructor
|
||||
*/
|
||||
private function __construct() { }
|
||||
|
||||
/**
|
||||
* Gets an instance of the configuration object
|
||||
*
|
||||
* Determines if a Config object has already been instantiated, if so it will
|
||||
* use it. If not, it will check to see if a frozen copy of the object is
|
||||
* available. If not, then a new object will be created.
|
||||
*
|
||||
* @return An instace of the Config class
|
||||
*/
|
||||
public static function getInstance() {
|
||||
$session = Session::getInstance();
|
||||
|
||||
|
@ -23,6 +55,16 @@ class Config extends Singleton {
|
|||
return self::$instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Loads a configuration file
|
||||
*
|
||||
* Handles the potentialy loading of the configuration file, sanitizing the
|
||||
* boolean values and freezing the instance for later use.
|
||||
*
|
||||
* @param string $file File name of the configuration file to be loaded
|
||||
* @return boolean Based on the success or failure of the file load
|
||||
* @todo Either get rid of or make better use of the Error object
|
||||
*/
|
||||
public function load($file) {
|
||||
$load = true;
|
||||
if (isset($this->file)) {
|
||||
|
@ -32,7 +74,8 @@ class Config extends Singleton {
|
|||
}
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
$load = true;
|
||||
if ($load) {
|
||||
if (file_exists($file)) {
|
||||
$this->file = $file;
|
||||
|
@ -42,13 +85,36 @@ class Config extends Singleton {
|
|||
if (is_array($config_array)) {
|
||||
foreach ($config_array as $variable => $value) {
|
||||
if ($value == 'true' || $value == array()) {
|
||||
$value = (bool) $value;
|
||||
$value = (bool)$value;
|
||||
}
|
||||
|
||||
$this->$variable = $value == array() ? (bool) $value : $value;
|
||||
$this->$variable = $value == array() ? (bool)$value : $value;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @todo Okay, now if no default section is specified, we'll
|
||||
* default to the first section listed. But what should be
|
||||
* done if no sections are specified? Perhaps force just
|
||||
* the index to load, or perhaps error out? I have to keep
|
||||
* in mind that single page sites exist where no navigation
|
||||
* will exist. So yeah, I suppose just specifying the
|
||||
* default would combat against that, or should I drill
|
||||
* down further, and see if any site level models exist and
|
||||
* load the first one, or even better I'm thinking that a
|
||||
* shared model / template would be good when nothing is
|
||||
* available. That would in turn tell the user to fix the
|
||||
* issue to be able to get it all working again. Damn,
|
||||
* this ended up being a long @todo.
|
||||
* @todo This may be better suited in the loop above since we're
|
||||
* already looping through all the values, we could snag it
|
||||
* in passing.
|
||||
*/
|
||||
if (!isset($this->navigation['default']) || $this->navigation['default'] == '') {
|
||||
$this->navigation['default'] = key($this->navigation['sections']);
|
||||
|
||||
}
|
||||
|
||||
$this->freeze();
|
||||
|
||||
return true;
|
||||
|
@ -59,7 +125,6 @@ class Config extends Singleton {
|
|||
}
|
||||
}
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
?>
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue