WEB-INF/lib/ttConfigHelper.class.php

   1 <?php
   2 // +----------------------------------------------------------------------+
   3 // | Anuko Time Tracker
   4 // +----------------------------------------------------------------------+
   5 // | Copyright (c) Anuko International Ltd. (https://www.anuko.com)
   6 // +----------------------------------------------------------------------+
   7 // | LIBERAL FREEWARE LICENSE: This source code document may be used
   8 // | by anyone for any purpose, and freely redistributed alone or in
   9 // | combination with other software, provided that the license is obeyed.
  10 // |
  11 // | There are only two ways to violate the license:
  12 // |
  13 // | 1. To redistribute this code in source form, with the copyright
  14 // |    notice or license removed or altered. (Distributing in compiled
  15 // |    forms without embedded copyright notices is permitted).
  16 // |
  17 // | 2. To redistribute modified versions of this code in *any* form
  18 // |    that bears insufficient indications that the modifications are
  19 // |    not the work of the original author(s).
  20 // |
  21 // | This license applies to this document only, not any other software
  22 // | that it may be combined with.
  23 // |
  24 // +----------------------------------------------------------------------+
  25 // | Contributors:
  26 // | https://www.anuko.com/time_tracker/credits.htm
  27 // +----------------------------------------------------------------------+
  28
  29 // Class ttConfigHelper is a helper class to handle comma-separated lists of config data.
  30 // For example, in tt_groups table we have a field called "config", that may store something like:
  31 //
  32 // allow_overlap,uncompleted_indicators,minutes_in_unit:15,future_entries
  33 //   Above, some values are simply defined by their presence such as allow_overlap.
  34 //   Other values have associated values after colon such as minutes_in_work_unit (15).
  35 class ttConfigHelper {
  36   var $config = null; // Source config string.
  37   var $config_array = null;  // Array of config values.
  38
  39   // Constructor.
  40   function __construct($config) {
  41     $this->config = $config;
  42     $this->config_array = explode(',', $this->config);
  43   }
  44
  45   // getDefinedValue determines if a value identified by name is defined.
  46   function getDefinedValue($name) {
  47     return in_array($name, $this->$config_array);
  48   }
  49
  50   // The getIntValue parses an integer value from the source config string.
  51   function getIntValue($name) {
  52     $name_with_colon = $name.':';
  53     $len = strlen($name_with_colon);
  54
  55     foreach ($this->config_array as $unparsed_value) {
  56       if (substr($unparsed_value, 0, $len) === $name_with_colon) {
  57         // Found value.
  58         $unparsed_len = strlen($unparsed_value);
  59         $int_value = (int) substr($unparsed_value, -($unparsed_len - $len));
  60         return $int_value;
  61       }
  62
  63     }
  64     return false;
  65   }
  66
  67   // The setIntValue sets an integer value into config array.
  68   function setIntValue($name, $value) {
  69     // Try to find and replace an already existing value.
  70     $name_with_colon = $name.':';
  71     $len = strlen($name_with_colon);
  72
  73     foreach ($this->config_array as $key => $unparsed_value) {
  74       if (substr($unparsed_value, 0, $len) === $name_with_colon) {
  75         // Found an already existing value.
  76         // Remove value if our new value is NULL.
  77         if ($value !== null) {
  78           // Replace value.
  79           $this->config_array[$key] = $name.':'.$value;
  80         } else {
  81           // Remove value.
  82           unset($this->config_array[$key]);
  83         }
  84         $this->config = implode(',', $this->config_array);
  85         return;
  86       }
  87     }
  88     // If we get here, the value was not found, so add it.
  89     $this->config_array[] = $name.':'.$value;
  90     $this->config = implode(',', $this->config_array);
  91     return;
  92   }
  93
  94   // The getConfig returns the config string.
  95   function getConfig() {
  96     return $this->config;
  97   }
  98 }