WEB-INF/lib/common.lib.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         /**
  30          * @return unknown
  31          * @param file unknown
  32          * @param version = "" unknown
  33          * @desc Loads a class
  34          */
  35         function import( $class_name ) {
  36             $libs = array(
  37                         dirname($_SERVER["SCRIPT_FILENAME"]),
  38                         LIBRARY_DIR
  39                 );
  40
  41             $pos = strpos($class_name, ".");
  42         if (!($pos === false)) {
  43             $peaces = explode(".", $class_name);
  44             $p = "";
  45             for ($i=0; $i<count($peaces)-1; $i++) {
  46                 $p = $p . "/" . $peaces[$i];
  47             }
  48                         $libs = array_merge(array(LIBRARY_DIR . $p),$libs);
  49             $class_name = $peaces[count($peaces)-1];
  50         }
  51
  52                 $filename = $class_name . '.class.php';
  53
  54                 foreach($libs as $lib) {
  55                         $inc_filename = $lib . '/' . $filename;
  56                         if (file_exists($inc_filename)) {
  57                                         require_once($inc_filename);
  58                                         return $class_name;
  59                         }
  60                 }
  61
  62                 print '<br><b>load_class: error loading file "'.$filename.'"</b>';
  63                 die();
  64         }
  65
  66         // The mu_sort function is used to sort a multi-dimensional array.
  67         // It looks like the code example is taken from the PHP manual http://ca2.php.net/manual/en/function.sort.php
  68         function mu_sort($array, $key_sort) {
  69                 $n = 0;
  70                 if (!is_array($array) || count($array)==0)
  71                         return array();
  72
  73                 $key_sorta = explode(",", $key_sort);
  74                 $keys = array_keys($array[0]);
  75
  76                 for($m=0; $m < count($key_sorta); $m++) {
  77                         $nkeys[$m] = trim($key_sorta[$m]);
  78                 }
  79                 $n += count($key_sorta);
  80
  81                 for($i=0; $i < count($keys); $i++) {
  82                         if(!in_array($keys[$i], $key_sorta)) {
  83                                 $nkeys[$n] = $keys[$i];
  84                                 $n += "1";
  85                         }
  86                 }
  87
  88                 for($u=0;$u<count($array); $u++) {
  89                         $arr = $array[$u];
  90                         for($s=0; $s<count($nkeys); $s++) {
  91                                 $k = $nkeys[$s];
  92                                 $output[$u][$k] = $array[$u][$k];
  93                         }
  94                 }
  95                 sort($output);
  96                 return $output;
  97         }
  98
  99         /**
 100          * return float type
 101          *
 102          * @param unknown $value
 103          * @return unknown
 104          */
 105         function toFloat($value) {
 106                 if (isset($value) && (strlen($value) > 0)) {
 107                         $value = str_replace(",",".",$value);
 108                         return floatval($value);
 109                 }
 110                 return null;
 111         }
 112
 113         function stripslashes_deep($value) {
 114             $value = is_array($value) ?
 115                 array_map('stripslashes_deep', $value) :
 116                 stripslashes($value);
 117         return $value;
 118         }
 119
 120         function &getConnection() {
 121         if (!isset($GLOBALS["_MDB2_CONNECTION"])) {
 122
 123                 require_once('MDB2.php');
 124
 125                 $mdb2 = MDB2::connect(DSN);
 126                         if (is_a($mdb2, 'PEAR_Error')) {
 127                         die($mdb2->getMessage());
 128                         }
 129
 130                         $mdb2->setOption('debug', true);
 131                         $mdb2->setFetchMode(MDB2_FETCHMODE_ASSOC);
 132
 133                         $GLOBALS["_MDB2_CONNECTION"] = $mdb2;
 134         }
 135         return $GLOBALS["_MDB2_CONNECTION"];
 136         }
 137
 138
 139         function closeConnection() {
 140                 if (isset($GLOBALS["_DB_CONNECTION"])) {
 141                         $GLOBALS["_DB_CONNECTION"]->close();
 142                         unset($GLOBALS["_DB_CONNECTION"]);
 143                 }
 144         }
 145
 146 function time_to_decimal($a) {
 147   $tmp = explode(":", $a);
 148   if($tmp[1]{0}=="0") $tmp[1] = $tmp[1]{1};
 149
 150   $m = round($tmp[1]*100/60);
 151
 152   if($m<10) $m = "0".$m;
 153   $time = $tmp[0].".".$m;
 154   return $time;
 155 }
 156
 157 function sec_to_time_fmt_hm($sec)
 158 {
 159   return sprintf("%d:%02d", $sec / 3600, $sec % 3600 / 60);
 160 }
 161
 162 function magic_quotes_off()
 163 {
 164   // if (get_magic_quotes_gpc()) { // This check is now done before calling this function.
 165     $_POST = array_map('stripslashes_deep', $_POST);
 166     $_GET = array_map('stripslashes_deep', $_GET);
 167     $_COOKIE = array_map('stripslashes_deep', $_COOKIE);
 168   // }
 169 }
 170
 171 // check_extension checks whether a required PHP extension is loaded and dies if not so.
 172 function check_extension($ext)
 173 {
 174   if (!extension_loaded($ext))
 175     die("PHP extension '{$ext}' is required but is not loaded. Read Time Tracker Install Guide for help.");
 176 }
 177
 178 // isTrue is a helper function to return correct false for older config.php values defined as a string 'false'.
 179 function isTrue($val)
 180 {
 181   return ($val == false || $val === 'false') ? false : true;
 182 }
 183
 184 // ttValidString is used to check user input to validate a string.
 185 function ttValidString($val, $emptyValid = false)
 186 {
 187   $val = trim($val);
 188   if (strlen($val) == 0 && !$emptyValid)
 189     return false;
 190
 191   // String must not be XSS evil (to insert JavaScript).
 192   if (stristr($val, '<script>') || stristr($val, '<script '))
 193     return false;
 194
 195   return true;
 196 }
 197
 198 // ttValidEmail is used to check user input to validate an email string.
 199 function ttValidEmail($val, $emptyValid = false)
 200 {
 201   $val = trim($val);
 202   if (strlen($val) == 0)
 203     return ($emptyValid ? true : false);
 204
 205   // String must not be XSS evil (to insert JavaScript).
 206   if (stristr($val, '<script>') || stristr($val, '<script '))
 207     return false;
 208
 209   // Validate a single email address. TODO: improve for compliancy with RFC.
 210   if (!preg_match("/^[_a-zA-Z\d\'-\.]+@([_a-zA-Z\d\-]+(\.[_a-zA-Z\d\-]+)+)$/", $val))
 211     return false;
 212
 213   return true;
 214 }
 215
 216 // ttValidEmailList is used to check user input to validate an email string.
 217 function ttValidEmailList($val, $emptyValid = false)
 218 {
 219   $val = trim($val);
 220   if (strlen($val) == 0)
 221     return ($emptyValid ? true : false);
 222
 223   // String must not be XSS evil (to insert JavaScript).
 224   if (stristr($val, '<script>') || stristr($val, '<script '))
 225     return false;
 226
 227   // Validates a list of email addresses separated by a comma with optional spaces.
 228   if (!preg_match("/^[_a-zA-Z\d\'-\.]+@([_a-zA-Z\d\-]+(\.[_a-zA-Z\d\-]+)+)(,\s*[_a-zA-Z\d\'-\.]+@([_a-zA-Z\d\-]+(\.[_a-zA-Z\d\-]+)+))*$/", $val))
 229     return false;
 230
 231   return true;
 232 }
 233
 234 // ttValidFloat is used to check user input to validate a float value.
 235 function ttValidFloat($val, $emptyValid = false)
 236 {
 237   $val = trim($val);
 238   if (strlen($val) == 0)
 239     return ($emptyValid ? true : false);
 240
 241   global $user;
 242   $decimal = $user->decimal_mark;
 243
 244   if (!preg_match('/^-?[0-9'.$decimal.']+$/', $val))
 245     return false;
 246
 247   return true;
 248 }
 249
 250 // ttValidDate is used to check user input to validate a date.
 251 function ttValidDate($val)
 252 {
 253   $val = trim($val);
 254   if (strlen($val) == 0)
 255     return false;
 256
 257   // This should accept a string in format 'YYYY-MM-DD', 'MM/DD/YYYY', 'DD.MM.YYYY', or 'DD.MM.YYYY whatever'.
 258   if (!preg_match('/^\d\d\d\d-\d\d-\d\d$/', $val) &&
 259     !preg_match('/^\d\d\/\d\d\/\d\d\d\d$/', $val) &&
 260     !preg_match('/^\d\d\.\d\d\.\d\d\d\d$/', $val) &&
 261     !preg_match('/^\d\d\.\d\d\.\d\d\d\d .+$/', $val))
 262     return false;
 263
 264   return true;
 265 }
 266
 267 // ttValidInteger is used to check user input to validate an integer.
 268 function ttValidInteger($val, $emptyValid = false)
 269 {
 270   $val = trim($val);
 271   if (strlen($val) == 0)
 272     return ($emptyValid ? true : false);
 273
 274   if (!preg_match('/^[0-9]+$/', $val))
 275     return false;
 276
 277   return true;
 278 }
 279
 280 // ttValidCronSpec is used to check user input to validate cron specification.
 281 function ttValidCronSpec($val)
 282 {
 283   // This code is adapted from http://stackoverflow.com/questions/235504/validating-crontab-entries-w-php
 284   $numbers= array(
 285      'min'=>'[0-5]?\d',
 286      'hour'=>'[01]?\d|2[0-3]',
 287      'day'=>'0?[1-9]|[12]\d|3[01]',
 288      'month'=>'[1-9]|1[012]',
 289      'dow'=>'[0-7]'
 290   );
 291
 292   foreach($numbers as $field=>$number) {
 293     $range= "($number)(-($number)(\/\d+)?)?";
 294     $field_re[$field]= "\*(\/\d+)?|$range(,$range)*";
 295   }
 296
 297   $field_re['month'].='|jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec';
 298   $field_re['dow'].='|mon|tue|wed|thu|fri|sat|sun';
 299
 300   $fields_re= '('.join(')\s+(', $field_re).')';
 301
 302   /*
 303   $replacements= '@reboot|@yearly|@annually|@monthly|@weekly|@daily|@midnight|@hourly';
 304
 305   $regexp = '^\s*('.
 306                 '$'.
 307                 '|#'.
 308                 '|\w+\s*='.
 309                 "|$fields_re\s+\S".
 310                 "|($replacements)\s+\S".
 311             ')';
 312    */
 313   // The above block from the link did not work for me.
 314
 315   // But this works.
 316   $regexp = '/^'.$fields_re.'$/';
 317
 318   if (!preg_match($regexp, $val))
 319     return false;
 320
 321   return true;
 322 }
 323
 324 // ttAccessCheck is used to check whether user is allowed to proceed. This function is used
 325 // as an initial check on all publicly available pages.
 326 function ttAccessCheck($required_rights)
 327 {
 328   global $auth;
 329   global $user;
 330
 331   // Redirect to login page if user is not authenticated.
 332   if (!$auth->isAuthenticated()) {
 333     header('Location: login.php');
 334     exit();
 335   }
 336
 337   // Check rights.
 338   if (!($required_rights & $user->rights))
 339     return false;
 340
 341   return true;
 342 }
 343
 344 // ttPluginEnabled is used to check whether a plugin is enabled for user.
 345 function ttPluginEnabled($plugin)
 346 {
 347   global $user;
 348   return in_array($plugin, explode(',', $user->plugins));
 349 }