lib/cache.php

   1 <?php
   2 /**
   3  * StatusNet, the distributed open-source microblogging tool
   4  *
   5  * Cache interface plus default in-memory cache implementation
   6  *
   7  * PHP version 5
   8  *
   9  * LICENCE: This program is free software: you can redistribute it and/or modify
  10  * it under the terms of the GNU Affero General Public License as published by
  11  * the Free Software Foundation, either version 3 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU Affero General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Affero General Public License
  20  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  21  *
  22  * @category  Cache
  23  * @package   StatusNet
  24  * @author    Evan Prodromou <evan@status.net>
  25  * @copyright 2009 StatusNet, Inc.
  26  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
  27  * @link      http://status.net/
  28  */
  29
  30 /**
  31  * Interface for caching
  32  *
  33  * An abstract interface for caching. Because we originally used the
  34  * Memcache plugin directly, the interface uses a small subset of the
  35  * Memcache interface.
  36  *
  37  * @category  Cache
  38  * @package   StatusNet
  39  * @author    Evan Prodromou <evan@status.net>
  40  * @copyright 2009 StatusNet, Inc.
  41  * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html AGPL 3.0
  42  * @link      http://status.net/
  43  */
  44
  45 class Cache
  46 {
  47     var $_items   = array();
  48     static $_inst = null;
  49
  50     /**
  51      * Singleton constructor
  52      *
  53      * Use this to get the singleton instance of Cache.
  54      *
  55      * @return Cache cache object
  56      */
  57
  58     static function instance()
  59     {
  60         if (is_null(self::$_inst)) {
  61             self::$_inst = new Cache();
  62         }
  63
  64         return self::$_inst;
  65     }
  66
  67     /**
  68      * Create a cache key from input text
  69      *
  70      * Builds a cache key from input text. Helps to namespace
  71      * the cache area (if shared with other applications or sites)
  72      * and prevent conflicts.
  73      *
  74      * @param string $extra the real part of the key
  75      *
  76      * @return string full key
  77      */
  78
  79     static function key($extra)
  80     {
  81         $base_key = common_config('memcached', 'base');
  82
  83         if (empty($base_key)) {
  84             $base_key = common_keyize(common_config('site', 'name'));
  85         }
  86
  87         return 'statusnet:' . $base_key . ':' . $extra;
  88     }
  89
  90     /**
  91      * Make a string suitable for use as a key
  92      *
  93      * Useful for turning primary keys of tables into cache keys.
  94      *
  95      * @param string $str string to turn into a key
  96      *
  97      * @return string keyized string
  98      */
  99
 100     static function keyize($str)
 101     {
 102         $str = strtolower($str);
 103         $str = preg_replace('/\s/', '_', $str);
 104         return $str;
 105     }
 106
 107     /**
 108      * Get a value associated with a key
 109      *
 110      * The value should have been set previously.
 111      *
 112      * @param string $key Lookup key
 113      *
 114      * @return string retrieved value or null if unfound
 115      */
 116
 117     function get($key)
 118     {
 119         $value = null;
 120
 121         if (Event::handle('StartCacheGet', array(&$key, &$value))) {
 122             if (array_key_exists($key, $this->_items)) {
 123                 common_log(LOG_INFO, 'Cache HIT for key ' . $key);
 124                 $value = $this->_items[$key];
 125             } else {
 126                 common_log(LOG_INFO, 'Cache MISS for key ' . $key);
 127             }
 128             Event::handle('EndCacheGet', array($key, &$value));
 129         }
 130
 131         return $value;
 132     }
 133
 134     /**
 135      * Set the value associated with a key
 136      *
 137      * @param string  $key    The key to use for lookups
 138      * @param string  $value  The value to store
 139      * @param integer $flag   Flags to use, mostly ignored
 140      * @param integer $expiry Expiry value, mostly ignored
 141      *
 142      * @return boolean success flag
 143      */
 144
 145     function set($key, $value, $flag=null, $expiry=null)
 146     {
 147         $success = false;
 148
 149         if (Event::handle('StartCacheSet', array(&$key, &$value, &$flag,
 150                                                  &$expiry, &$success))) {
 151             common_log(LOG_INFO, 'Setting cache value for key ' . $key);
 152
 153             $this->_items[$key] = $value;
 154
 155             $success = true;
 156
 157             Event::handle('EndCacheSet', array($key, $value, $flag,
 158                                                $expiry));
 159         }
 160
 161         return $success;
 162     }
 163
 164     /**
 165      * Delete the value associated with a key
 166      *
 167      * @param string $key Key to delete
 168      *
 169      * @return boolean success flag
 170      */
 171
 172     function delete($key)
 173     {
 174         $success = false;
 175
 176         if (Event::handle('StartCacheDelete', array(&$key, &$success))) {
 177             if (array_key_exists($key, $this->_items[$key])) {
 178                 common_log(LOG_INFO, 'Deleting cache value for key ' . $key);
 179                 unset($this->_items[$key]);
 180             }
 181             $success = true;
 182             Event::handle('EndCacheDelete', array($key));
 183         }
 184
 185         return $success;
 186     }
 187 }