debug option for mail renderer

[bdrem.git] / src / bdrem / Config.php

diff --git a/src/bdrem/Config.php b/src/bdrem/Config.php
index a79b1b3c5b53ec21799689f9903d057a1189d448..693307eec22154cfdba4e462b826cf4563c75758 100644 (file)
--- a/src/bdrem/Config.php
+++ b/src/bdrem/Config.php
@@ -1,21 +1,110 @@
 <?php
+/**
+ * Part of bdrem
+ *
+ * PHP version 5
+ *
+ * @category  Tools
+ * @package   Bdrem
+ * @author    Christian Weiske <cweiske@cweiske.de>
+ * @copyright 2014 Christian Weiske
+ * @license   http://www.gnu.org/licenses/agpl.html GNU AGPL v3
+ * @link      http://cweiske.de/bdrem.htm
+ */
 namespace bdrem;
 
+/**
+ * Configuration options for bdrem
+ *
+ * @category  Tools
+ * @package   Bdrem
+ * @author    Christian Weiske <cweiske@cweiske.de>
+ * @copyright 2014 Christian Weiske
+ * @license   http://www.gnu.org/licenses/agpl.html GNU AGPL v3
+ * @version   Release: @package_version@
+ * @link      http://cweiske.de/bdrem.htm
+ */
 class Config
 {
-    public $source;
+    /**
+     * Current date, YYYY-MM-DD
+     * @var string
+     */
     public $date;
-    public $daysPrev = 3;
-    public $daysNext = 7;
+
+    /**
+     * Days to show before $date
+     * @var integer
+     */
+    public $daysPrev;
+
+    /**
+     * Days to show after $date
+     * @var integer
+     */
+    public $daysNext;
+
+    /**
+     * Development helper
+     * @var boolean
+     */
+    public $debug;
+
+    /**
+     * Locale to render the dates in, e.g. "de_DE.UTF-8"
+     * @var string
+     */
     public $locale;
-    public $stopOnEmpty = false;
 
+    /**
+     * Renderer name to use (e.g. "console")
+     * @var string
+     */
+    public $renderer;
+
+    /**
+     * Event source configuration.
+     * - First value is source name ("Ldap", "Sql")
+     * - Second value is the source configuration
+     * @var array
+     */
+    public $source;
+
+    /**
+     * Do not output anything if there are no events to show
+     * @var boolean
+     */
+    public $stopOnEmpty;
+
+    /**
+     * List of config file paths that were tried to load
+     * @var array
+     */
     public $cfgFiles = array();
+
+    /**
+     * If a configuration file could be found
+     * @var boolean
+     */
     public $cfgFileExists;
 
-    public function load()
+
+
+    /**
+     * Init configuration file path loading
+     */
+    public function __construct()
     {
         $this->loadConfigFilePaths();
+    }
+
+    /**
+     * Load the configuration from the first configuration file found.
+     *
+     * @return void
+     */
+    public function load()
+    {
         foreach ($this->cfgFiles as $file) {
             if (file_exists($file)) {
                 $this->cfgFileExists = true;
@@ -25,6 +114,11 @@ class Config
         $this->cfgFileExists = false;
     }
 
+    /**
+     * Load possible configuration file paths into $this->cfgFiles.
+     *
+     * @return void
+     */
     protected function loadConfigFilePaths()
     {
         $pharFile = \Phar::running();
@@ -40,15 +134,30 @@ class Config
         $this->cfgFiles[] = '/etc/bdrem.php';
     }
 
+    /**
+     * Load a single configuration file and set the config class variables
+     *
+     * @param string $filename Configuration file path
+     *
+     * @return void
+     */
     protected function loadFile($filename)
     {
         include $filename;
         $vars = get_defined_vars();
         foreach ($vars as $k => $value) {
-            $this->$k = $value;
+            if (!isset($this->$k) || $this->$k === null) {
+                $this->$k = $value;
+            }
         }
     }
 
+    /**
+     * Load a event source from $this->source.
+     * Class name has to be \bdrem\Source_$source
+     *
+     * @return object Source object
+     */
     public function loadSource()
     {
         if ($this->source === null) {
@@ -61,6 +170,13 @@ class Config
         return new $class($settings[0]);
     }
 
+    /**
+     * Set the current date
+     *
+     * @param string $date Date in any format
+     *
+     * @return void
+     */
     public function setDate($date)
     {
         if ($date === null) {
@@ -71,6 +187,15 @@ class Config
         }
     }
 
+    /**
+     * Get a configuration variable
+     *
+     * @param string $varname Configuration variable name
+     * @param string $default Default value in case the variable is not set
+     *                        or is empty
+     *
+     * @return mixed Configuration value or default
+     */
     public function get($varname, $default = '')
     {
         if (!isset($this->$varname) || $this->$varname == '') {