nucleus/libs/MANAGER.php

   1 <?php\r
   2 /*\r
   3  * Nucleus: PHP/MySQL Weblog CMS (http://nucleuscms.org/)\r
   4  * Copyright (C) 2002-2009 The Nucleus Group\r
   5  *\r
   6  * This program is free software; you can redistribute it and/or\r
   7  * modify it under the terms of the GNU General Public License\r
   8  * as published by the Free Software Foundation; either version 2\r
   9  * of the License, or (at your option) any later version.\r
  10  * (see nucleus/documentation/index.html#license for more info)\r
  11  */\r
  12 /**\r
  13  * This class makes sure each item/weblog/comment object gets requested from\r
  14  * the database only once, by keeping them in a cache. The class also acts as\r
  15  * a dynamic classloader, loading classes _only_ when they are first needed,\r
  16  * hoping to diminish execution time\r
  17  *\r
  18  * The class is a singleton, meaning that there will be only one object of it\r
  19  * active at all times. The object can be requested using Manager::instance()\r
  20  *\r
  21  * @license http://nucleuscms.org/license.txt GNU General Public License\r
  22  * @copyright Copyright (C) 2002-2009 The Nucleus Group\r
  23  * @version $Id: MANAGER.php 1731 2012-04-08 15:10:35Z sakamocchi $\r
  24  */\r
  25 class Manager\r
  26 {\r
  27         /**\r
  28          * Cached ITEM, BLOG, PLUGIN, KARMA and MEMBER objects. When these objects are requested\r
  29          * through the global $manager object (getItem, getBlog, ...), only the first call\r
  30          * will create an object. Subsequent calls will return the same object.\r
  31          *\r
  32          * The $items, $blogs, ... arrays map an id to an object (for plugins, the name is used\r
  33          * rather than an ID)\r
  34          */\r
  35         var $items;\r
  36         var $blogs;\r
  37         var $plugins;\r
  38         var $karma;\r
  39         var $templates;\r
  40         var $members;\r
  41         \r
  42         /**\r
  43          * cachedInfo to avoid repeated SQL queries (see pidInstalled/pluginInstalled/getPidFromName)\r
  44          * e.g. which plugins exists?\r
  45          *\r
  46          * $cachedInfo['installedPlugins'] = array($pid -> $name)\r
  47          */\r
  48         private $cachedInfo;\r
  49         \r
  50         /**\r
  51          * The plugin subscriptionlist\r
  52          *\r
  53          * The subcription array has the following structure\r
  54          *              $subscriptions[$EventName] = array containing names of plugin classes to be\r
  55          *                                                                       notified when that event happens\r
  56          * \r
  57          * NOTE: this is referred by Comments::addComment() for spamcheck API\r
  58          * TODO: we should add new methods to get this\r
  59          */\r
  60         public $subscriptions;\r
  61         \r
  62         /**\r
  63          * Ticket functions. These are uses by the admin area to make it impossible to simulate certain GET/POST\r
  64          * requests. tickets are user specific\r
  65          */\r
  66         private $currentRequestTicket = '';\r
  67         \r
  68         /**\r
  69          * Returns the only instance of this class. Creates the instance if it\r
  70          * does not yet exists. Users should use this function as\r
  71          * $manager =& Manager::instance(); to get a reference to the object\r
  72          * instead of a copy\r
  73          */\r
  74         public function &instance()\r
  75         {\r
  76                 static $instance = array();\r
  77                 if ( empty($instance) )\r
  78                 {\r
  79                         $instance[0] = new Manager();\r
  80                 }\r
  81                 return $instance[0];\r
  82         }\r
  83         \r
  84         /**\r
  85          * The constructor of this class initializes the object caches\r
  86          */\r
  87         public function __construct()\r
  88         {\r
  89                 $this->items = array();\r
  90                 $this->blogs = array();\r
  91                 $this->plugins = array();\r
  92                 $this->karma = array();\r
  93                 $this->parserPrefs = array();\r
  94                 $this->cachedInfo = array();\r
  95                 return;\r
  96         }\r
  97         \r
  98         /**\r
  99          * Returns the requested item object. If it is not in the cache, it will\r
 100          * first be loaded and then placed in the cache.\r
 101          * Intended use: $item =& $manager->getItem(1234)\r
 102          */\r
 103         public function &getItem($itemid, $allowdraft, $allowfuture)\r
 104         {\r
 105                 $item =& $this->items[$itemid];\r
 106                 \r
 107                 // check the draft and future rules if the item was already cached\r
 108                 if ( $item )\r
 109                 {\r
 110                         if ( (!$allowdraft) && ($item['draft']) )\r
 111                         {\r
 112                                 return 0;\r
 113                         }\r
 114                         \r
 115                         $blog =& $this->getBlog(getBlogIDFromItemID($itemid));\r
 116                         \r
 117                         if ( (!$allowfuture) && ($item['timestamp'] > $blog->getCorrectTime()) )\r
 118                         {\r
 119                                 return 0;\r
 120                         }\r
 121                 }\r
 122                 \r
 123                 if ( !$item )\r
 124                 {\r
 125                         // load class if needed\r
 126                         $this->loadClass('ITEM');\r
 127                         // load item object\r
 128                         $item = Item::getitem($itemid, $allowdraft, $allowfuture);\r
 129                         $this->items[$itemid] = $item;\r
 130                 }\r
 131                 return $item;\r
 132         }\r
 133         \r
 134         /**\r
 135          * Loads a class if it has not yet been loaded\r
 136          */\r
 137         public function loadClass($name)\r
 138         {\r
 139                 $this->_loadClass($name, $name . '.php');\r
 140                 return;\r
 141         }\r
 142         \r
 143         /**\r
 144          * Checks if an item exists\r
 145          */\r
 146         public function existsItem($id,$future,$draft)\r
 147         {\r
 148                 $this->_loadClass('ITEM','ITEM.php');\r
 149                 return Item::exists($id,$future,$draft);\r
 150         }\r
 151         \r
 152         /**\r
 153          * Checks if a category exists\r
 154          */\r
 155         public function existsCategory($id)\r
 156         {\r
 157                 return (quickQuery('SELECT COUNT(*) as result FROM '.sql_table('category').' WHERE catid='.intval($id)) > 0);\r
 158         }\r
 159         \r
 160         /**\r
 161          * Returns the blog object for a given blogid\r
 162          */\r
 163         public function &getBlog($blogid)\r
 164         {\r
 165                 $blog =& $this->blogs[$blogid];\r
 166                 \r
 167                 if ( !$blog )\r
 168                 {\r
 169                         // load class if needed\r
 170                         $this->_loadClass('BLOG','BLOG.php');\r
 171                         // load blog object\r
 172                         $blog = new Blog($blogid);\r
 173                         $this->blogs[$blogid] =& $blog;\r
 174                 }\r
 175                 return $blog;\r
 176         }\r
 177         \r
 178         /**\r
 179          * Checks if a blog exists\r
 180          */\r
 181         public function existsBlog($name)\r
 182         {\r
 183                 $this->_loadClass('BLOG','BLOG.php');\r
 184                 return Blog::exists($name);\r
 185         }\r
 186         \r
 187         /**\r
 188          * Checks if a blog id exists\r
 189          */\r
 190         public function existsBlogID($id)\r
 191         {\r
 192                 $this->_loadClass('BLOG','BLOG.php');\r
 193                 return Blog::existsID($id);\r
 194         }\r
 195         \r
 196         /**\r
 197          * Returns a previously read template\r
 198          */\r
 199         public function &getTemplate($templateName)\r
 200         {\r
 201                 $template =& $this->templates[$templateName];\r
 202                 \r
 203                 if ( !$template )\r
 204                 {\r
 205                         $template = Template::read($templateName);\r
 206                         $this->templates[$templateName] =& $template;\r
 207                 }\r
 208                 return $template;\r
 209         }\r
 210         \r
 211         /**\r
 212          * Returns a KARMA object (karma votes)\r
 213          */\r
 214         public function &getKarma($itemid)\r
 215         {\r
 216                 $karma =& $this->karma[$itemid];\r
 217                 \r
 218                 if ( !$karma )\r
 219                 {\r
 220                         // load class if needed\r
 221                         $this->_loadClass('KARMA','KARMA.php');\r
 222                         // create KARMA object\r
 223                         $karma = new Karma($itemid);\r
 224                         $this->karma[$itemid] =& $karma;\r
 225                 }\r
 226                 return $karma;\r
 227         }\r
 228         \r
 229         /**\r
 230          * Returns a MEMBER object\r
 231          */\r
 232         public function &getMember($memberid)\r
 233         {\r
 234                 $mem =& $this->members[$memberid];\r
 235                 \r
 236                 if ( !$mem )\r
 237                 {\r
 238                         // load class if needed\r
 239                         $this->_loadClass('MEMBER','MEMBER.php');\r
 240                         // create MEMBER object\r
 241                         $mem =& Member::createFromID($memberid);\r
 242                         $this->members[$memberid] =& $mem;\r
 243                 }\r
 244                 return $mem;\r
 245         }\r
 246         \r
 247         /**\r
 248          * Set the global parser preferences\r
 249          */\r
 250         public function setParserProperty($name, $value)\r
 251         {\r
 252                 $this->parserPrefs[$name] = $value;\r
 253                 return;\r
 254         }\r
 255         \r
 256         /**\r
 257          * Get the global parser preferences\r
 258          */\r
 259         public function getParserProperty($name)\r
 260         {\r
 261                 return $this->parserPrefs[$name];\r
 262         }\r
 263         \r
 264         /**\r
 265          * A helper function to load a class\r
 266          * \r
 267          *      private\r
 268          */\r
 269         private function _loadClass($name, $filename)\r
 270         {\r
 271                 if ( !class_exists($name) )\r
 272                 {\r
 273                                 global $DIR_LIBS;\r
 274                                 include($DIR_LIBS . $filename);\r
 275                 }\r
 276                 return;\r
 277         }\r
 278         \r
 279         /**\r
 280          * Manager::_loadPlugin()\r
 281          * loading a certain plugin\r
 282          * \r
 283          * @param       string $name plugin name\r
 284          * @return      void\r
 285          */\r
 286         private function _loadPlugin($name)\r
 287         {\r
 288                 global $DIR_PLUGINS, $MYSQL_HANDLER, $MYSQL_PREFIX;\r
 289                 \r
 290                 if ( class_exists($name) )\r
 291                 {\r
 292                         return;\r
 293                 }\r
 294                 \r
 295                 $fileName = "{$DIR_PLUGINS}{$name}.php";\r
 296                 \r
 297                 if ( !file_exists($fileName) )\r
 298                 {\r
 299                         if ( !defined('_MANAGER_PLUGINFILE_NOTFOUND') )\r
 300                         {\r
 301                                 define('_MANAGER_PLUGINFILE_NOTFOUND', 'Plugin %s was not loaded (File not found)');\r
 302                         }\r
 303                         ActionLog::add(WARNING, sprintf(_MANAGER_PLUGINFILE_NOTFOUND, $name)); \r
 304                         return 0;\r
 305                 }\r
 306                 \r
 307                 // load plugin\r
 308                 include($fileName);\r
 309                 \r
 310                 // check if class exists (avoid errors in eval'd code)\r
 311                 if ( !class_exists($name) )\r
 312                 {\r
 313                         ActionLog::add(WARNING, sprintf(_MANAGER_PLUGINFILE_NOCLASS, $name));\r
 314                         return 0;\r
 315                 }\r
 316                 \r
 317                 // add to plugin array\r
 318                 $this->plugins[$name] = new $name();\r
 319                 \r
 320                 // get plugid\r
 321                 $this->plugins[$name]->setID($this->getPidFromName($name));\r
 322                 \r
 323                 // unload plugin if a prefix is used and the plugin cannot handle this\r
 324                 if ( ($MYSQL_PREFIX != '')\r
 325                   && !$this->plugins[$name]->supportsFeature('SqlTablePrefix') )\r
 326                 {\r
 327                         unset($this->plugins[$name]);\r
 328                         ActionLog::add(WARNING, sprintf(_MANAGER_PLUGINTABLEPREFIX_NOTSUPPORT, $name));\r
 329                         return 0;\r
 330                 }\r
 331                 \r
 332                 // unload plugin if using non-mysql handler and plugin does not support it \r
 333                 if ( (!in_array('mysql',$MYSQL_HANDLER))\r
 334                   && !$this->plugins[$name]->supportsFeature('SqlApi') )\r
 335                 {\r
 336                         unset($this->plugins[$name]);\r
 337                         ActionLog::add(WARNING, sprintf(_MANAGER_PLUGINSQLAPI_NOTSUPPORT, $name));\r
 338                         return 0;\r
 339                 }\r
 340                 \r
 341                 // call init method\r
 342                 $this->plugins[$name]->init();\r
 343                 \r
 344                 return;\r
 345         }\r
 346 \r
 347         /**\r
 348          * Manager:getPlugin()\r
 349          * Returns a PLUGIN object\r
 350          * \r
 351          * @param       string  $name   name of plugin\r
 352          * @return      object  plugin object\r
 353          */\r
 354         public function &getPlugin($name)\r
 355         {\r
 356                 // retrieve the name of the plugin in the right capitalisation\r
 357                 $name = $this->getUpperCaseName ($name);\r
 358                 \r
 359                 // get the plugin       \r
 360                 $plugin =& $this->plugins[$name]; \r
 361                 \r
 362                 if ( !$plugin )\r
 363                 {\r
 364                         // load class if needed\r
 365                         $this->_loadPlugin($name);\r
 366                         $plugin =& $this->plugins[$name];\r
 367                 }\r
 368                 return $plugin;\r
 369         }\r
 370         \r
 371         /**\r
 372          * Manager::pluginLoaded()\r
 373          * Checks if the given plugin IS loaded or not\r
 374          * \r
 375          * @param       string  $name   name of plugin\r
 376          * @return      object  plugin object\r
 377          */\r
 378         public function &pluginLoaded($name)\r
 379         {\r
 380                 $plugin =& $this->plugins[$name];\r
 381                 return $plugin;\r
 382         }\r
 383         \r
 384         /**\r
 385          * Manager::pidLoaded()\r
 386          * \r
 387          * @param       integer $pid    id for plugin\r
 388          * @return      object  plugin object\r
 389          */\r
 390         public function &pidLoaded($pid)\r
 391         {\r
 392                 $plugin=false;\r
 393                 reset($this->plugins);\r
 394                 while ( list($name) = each($this->plugins) )\r
 395                 {\r
 396                         if ( $pid!=$this->plugins[$name]->getId() )\r
 397                         {\r
 398                                 continue;\r
 399                         }\r
 400                         $plugin= & $this->plugins[$name];\r
 401                         break;\r
 402                 }\r
 403                 return $plugin;\r
 404         }\r
 405         \r
 406         /**\r
 407          * Manager::pluginInstalled()\r
 408          * checks if the given plugin IS installed or not\r
 409          * \r
 410          * @param       string  $name   name of plugin\r
 411          * @return      boolean exists or not\r
 412          */\r
 413         public function pluginInstalled($name)\r
 414         {\r
 415                 $this->_initCacheInfo('installedPlugins');\r
 416                 return ($this->getPidFromName($name) != -1);\r
 417         }\r
 418 \r
 419         /**\r
 420          * Manager::pidInstalled()\r
 421          * checks if the given plugin IS installed or not\r
 422          * \r
 423          * @param       integer $pid    id of plugin\r
 424          * @return      boolean exists or not\r
 425          */\r
 426         public function pidInstalled($pid)\r
 427         {\r
 428                 $this->_initCacheInfo('installedPlugins');\r
 429                 return ($this->cachedInfo['installedPlugins'][$pid] != '');\r
 430         }\r
 431         \r
 432         /**\r
 433          * Manager::getPidFromName()\r
 434          * \r
 435          * @param       string  $name   name of plugin\r
 436          * @return      mixed   id for plugin or -1 if not exists\r
 437          */\r
 438         public function getPidFromName($name)\r
 439         {\r
 440                 $this->_initCacheInfo('installedPlugins');\r
 441                 foreach ( $this->cachedInfo['installedPlugins'] as $pid => $pfile )\r
 442                 {\r
 443                         if (strtolower($pfile) == strtolower($name))\r
 444                         {\r
 445                                 return $pid;\r
 446                         }\r
 447                 }\r
 448                 return -1;\r
 449         }\r
 450         \r
 451         /**\r
 452          * Manager::getUpperCaseName()\r
 453          * Retrieve the name of a plugin in the right capitalisation\r
 454          * \r
 455          * @param       string  $name   name of plugin\r
 456          * @return      string  name according to UpperCamelCase\r
 457          */\r
 458         public function getUpperCaseName ($name)\r
 459         {\r
 460                 $this->_initCacheInfo('installedPlugins');\r
 461                 foreach ( $this->cachedInfo['installedPlugins'] as $pid => $pfile )\r
 462                 {\r
 463                         if ( strtolower($pfile) == strtolower($name) )\r
 464                         {\r
 465                                 return $pfile;\r
 466                         }\r
 467                 }\r
 468                 return -1;\r
 469         }\r
 470         \r
 471         /**\r
 472          * Manager::clearCachedInfo()\r
 473          * \r
 474          * @param       string  $what\r
 475          * @return      void\r
 476          */\r
 477         public function clearCachedInfo($what)\r
 478         {\r
 479                 unset($this->cachedInfo[$what]);\r
 480                 return;\r
 481         }\r
 482         \r
 483         /**\r
 484          * Manager::_initCacheInfo()\r
 485          * Loads some info on the first call only\r
 486          * \r
 487          * @param       string  $what   'installedPlugins'\r
 488          * @return      void\r
 489          */\r
 490         private function _initCacheInfo($what)\r
 491         {\r
 492                 if ( array_key_exists($what, $this->cachedInfo)\r
 493                   && is_array($this->cachedInfo[$what]) )\r
 494                 {\r
 495                         return;\r
 496                 }\r
 497                 \r
 498                 switch ($what)\r
 499                 {\r
 500                         // 'installedPlugins' = array ($pid => $name)\r
 501                         case 'installedPlugins':\r
 502                                 $this->cachedInfo['installedPlugins'] = array();\r
 503                                 $res = sql_query('SELECT pid, pfile FROM ' . sql_table('plugin'));\r
 504                                 while ( $o = sql_fetch_object($res) )\r
 505                                 {\r
 506                                         $this->cachedInfo['installedPlugins'][$o->pid] = $o->pfile;\r
 507                                 }\r
 508                                 break;\r
 509                 }\r
 510                 return;\r
 511         }\r
 512         \r
 513         /**\r
 514          * Manager::notify()\r
 515          * A function to notify plugins that something has happened. Only the plugins\r
 516          * that are subscribed to the event will get notified.\r
 517          * Upon the first call, the list of subscriptions will be fetched from the\r
 518          * database. The plugins itsself will only get loaded when they are first needed\r
 519          *\r
 520          * @param       string  $eventName      Name of the event (method to be called on plugins)\r
 521          * @param       string  $data           Can contain any type of data,\r
 522          *                                                              depending on the event type. Usually this is an itemid, blogid, ...\r
 523          *                                                              but it can also be an array containing multiple values\r
 524          * @return      void\r
 525          */\r
 526         public function notify($eventName, $data)\r
 527         {\r
 528                 // load subscription list if needed\r
 529                 if ( !is_array($this->subscriptions) )\r
 530                 {\r
 531                         $this->_loadSubscriptions();\r
 532                 }\r
 533                 \r
 534                 // get listening objects\r
 535                 $listeners = false;\r
 536                 if ( array_key_exists($eventName, $this->subscriptions)\r
 537                   && !empty($this->subscriptions[$eventName]) )\r
 538                 {\r
 539                         $listeners = $this->subscriptions[$eventName];\r
 540                 }\r
 541                 \r
 542                 // notify all of them\r
 543                 if ( is_array($listeners) )\r
 544                 {\r
 545                         foreach( $listeners as $listener )\r
 546                         {\r
 547                                 // load class if needed\r
 548                                 $this->_loadPlugin($listener);\r
 549                                 \r
 550                                 // do notify (if method exists)\r
 551                                 if ( array_key_exists($listener, $this->plugins)\r
 552                                   && !empty($this->plugins[$listener])\r
 553                                   && method_exists($this->plugins[$listener], 'event_' . $eventName) )\r
 554                                 {\r
 555                                         call_user_func(array(&$this->plugins[$listener],'event_' . $eventName), $data);\r
 556                                 }\r
 557                         }\r
 558                 }\r
 559                 return;\r
 560         }\r
 561         \r
 562         /**\r
 563          * Manager::_loadSubscriptions()\r
 564          * Loads plugin subscriptions\r
 565          * \r
 566          * @param       void\r
 567          * @return      void\r
 568          */\r
 569         private function _loadSubscriptions()\r
 570         {\r
 571                 // initialize as array\r
 572                 $this->subscriptions = array();\r
 573                 \r
 574                 $query = "SELECT p.pfile as pfile, e.event as event"\r
 575                        . " FROM %s as e, %s as p"\r
 576                        . " WHERE e.pid=p.pid ORDER BY p.porder ASC";\r
 577                 $query = sprintf($query, sql_table('plugin_event'), sql_table('plugin'));\r
 578                 $res = sql_query($query);\r
 579                 \r
 580                 while ( $o = sql_fetch_object($res) )\r
 581                 {\r
 582                         $pluginName = $o->pfile;\r
 583                         $eventName = $o->event;\r
 584                         $this->subscriptions[$eventName][] = $pluginName;\r
 585                 }\r
 586                 return;\r
 587         }\r
 588         \r
 589         /**\r
 590          * Manager::addTicketToUrl()\r
 591          * GET requests: Adds ticket to URL (URL should NOT be html-encoded!, ticket is added at the end)\r
 592          * \r
 593          * @param       string  url     string for URI\r
 594          * @return      void\r
 595          */\r
 596         public function addTicketToUrl($url)\r
 597         {\r
 598                 $ticketCode = 'ticket=' . $this->_generateTicket();\r
 599                 if ( strstr($url, '?') )\r
 600                 {\r
 601                         $ticketCode = "{$url}&{$ticketCode}";\r
 602                 }\r
 603                 else\r
 604                 {\r
 605                         $ticketCode = "{$url}?{$ticketCode}";\r
 606                 }\r
 607                 return $ticketCode;\r
 608         }\r
 609         \r
 610         /**\r
 611          * Manager::addTicketHidden()\r
 612          * POST requests: Adds ticket as hidden formvar\r
 613          * \r
 614          * @param       void\r
 615          * @return      void\r
 616          */\r
 617         public function addTicketHidden()\r
 618         {\r
 619                 $ticket = $this->_generateTicket();\r
 620                 echo '<input type="hidden" name="ticket" value="', Entity::hsc($ticket), '" />';\r
 621                 return;\r
 622         }\r
 623         \r
 624         /**\r
 625          * Manager::getNewTicket()\r
 626          * Get a new ticket\r
 627          * (xmlHTTPRequest AutoSaveDraft uses this to refresh the ticket)\r
 628          * \r
 629          * @param       void\r
 630          * @return      string  string of ticket\r
 631          */\r
 632         public function getNewTicket()\r
 633         {\r
 634                 $this->currentRequestTicket = '';\r
 635                 return $this->_generateTicket();\r
 636         }\r
 637         \r
 638         /**\r
 639          * Manager::checkTicket()\r
 640          * Checks the ticket that was passed along with the current request\r
 641          * \r
 642          * @param       void\r
 643          * @return      boolean correct or not\r
 644          */\r
 645         public function checkTicket()\r
 646         {\r
 647                 global $member;\r
 648                 \r
 649                 // get ticket from request\r
 650                 $ticket = requestVar('ticket');\r
 651                 \r
 652                 // no ticket -> don't allow\r
 653                 if ( $ticket == '' )\r
 654                 {\r
 655                         return FALSE;\r
 656                 }\r
 657                 \r
 658                 // remove expired tickets first\r
 659                 $this->_cleanUpExpiredTickets();\r
 660                 \r
 661                 // get member id\r
 662                 if (!$member->isLoggedIn())\r
 663                 {\r
 664                         $memberId = -1;\r
 665                 }\r
 666                 else\r
 667                 {\r
 668                         $memberId = $member->getID();\r
 669                 }\r
 670                 \r
 671                 // check if ticket is a valid one\r
 672                 $query = 'SELECT COUNT(*) as result FROM ' . sql_table('tickets') . ' WHERE member=' . intval($memberId). ' and ticket=\''.sql_real_escape_string($ticket).'\'';\r
 673                 \r
 674                 /*\r
 675                  * NOTE:\r
 676                  * [in the original implementation, the checked ticket was deleted. This would lead to invalid\r
 677                  * tickets when using the browsers back button and clicking another link/form\r
 678                  * leaving the keys in the database is not a real problem, since they're member-specific and\r
 679                  * only valid for a period of one hour]\r
 680                  */\r
 681                 if ( quickQuery($query) != 1 )\r
 682                 {\r
 683                         return FALSE;\r
 684                 }\r
 685                 \r
 686                 return TRUE;\r
 687         }\r
 688 \r
 689         /**\r
 690          * Manager::_cleanUpExpiredTickets()\r
 691          * Removes the expired tickets\r
 692          * \r
 693          * @param       void\r
 694          * @return      void\r
 695          */\r
 696         private function _cleanUpExpiredTickets()\r
 697         {\r
 698                 // remove tickets older than 1 hour\r
 699                 $oldTime = time() - 60 * 60;\r
 700                 $query = "DELETE FROM %s WHERE ctime < '%s';";\r
 701                 $query = sprintf($query, sql_table('tickets'), date('Y-m-d H:i:s',$oldTime));\r
 702                 sql_query($query);\r
 703                 return;\r
 704         }\r
 705         \r
 706         /**\r
 707          * Manager::_generateTicket()\r
 708          * Generates/returns a ticket (one ticket per page request)\r
 709          * \r
 710          * @param       void\r
 711          * @return      void\r
 712          */\r
 713         private function _generateTicket()\r
 714         {\r
 715                 if ( $this->currentRequestTicket == '' )\r
 716                 {\r
 717                         // generate new ticket (only one ticket will be generated per page request)\r
 718                         // and store in database\r
 719                         global $member;\r
 720                         // get member id\r
 721                         if ( !$member->isLoggedIn() )\r
 722                         {\r
 723                                 $memberId = -1;\r
 724                         }\r
 725                         else\r
 726                         {\r
 727                                 $memberId = $member->getID();\r
 728                         }\r
 729                         \r
 730                         $ok = false;\r
 731                         while ( !$ok )\r
 732                         {\r
 733                                 // generate a random token\r
 734                                 srand((double)microtime()*1000000);\r
 735                                 $ticket = md5(uniqid(rand(), true));\r
 736                                 \r
 737                                 // add in database as non-active\r
 738                                 $query = "INSERT INTO %s (ticket, member, ctime)"\r
 739                                        . " VALUES ('%s', %d, '%s');";\r
 740                                 $query = sprintf($query, sql_table('tickets'), sql_real_escape_string($ticket), (integer) $memberId, date('Y-m-d H:i:s',time()));\r
 741                                 \r
 742                                 if ( sql_query($query) )\r
 743                                 {\r
 744                                         $ok = true;\r
 745                                 }\r
 746                         }\r
 747                         $this->currentRequestTicket = $ticket;\r
 748                 }\r
 749                 return $this->currentRequestTicket;\r
 750         }\r
 751 }\r
 752 \r