function cache_set in Memcache API and Integration 5.2

Same name in this branch

1. 5.2 memcache.db.inc \cache_set()
2. 5.2 memcache.inc \cache_set()

Same name and namespace in other branches

1. 5 memcache.db.inc \cache_set()
2. 5 memcache.inc \cache_set()
3. 6 memcache.db.inc \cache_set()
4. 6 memcache.inc \cache_set()

Store data in memcache.

Parameters

$cid: The cache ID of the data to store.

$table: The table $table to store the data in. Valid core values are 'cache_filter', 'cache_menu', 'cache_page', or 'cache'.

$data: The data to store in the cache. Complex data types must be serialized first.

$expire: One of the following values:

• CACHE_PERMANENT: Indicates that the item should never be removed unless explicitly told to using cache_clear_all() with a cache ID.
• CACHE_TEMPORARY: Indicates that the item should be removed at the next general cache wipe.
• A Unix timestamp: Indicates that the item should be kept at least until the given time, after which it behaves like CACHE_TEMPORARY.

$headers: A string containing HTTP header information for cached pages.

$db_storage: This boolean is unique to the memcache.inc implementation of cache set. It allows us to do a cache_set and not write to the database, but only to memcache.

1 call to cache_set()

cache_get in ./memcache.db.inc

Return data from the persistent cache.

File

./memcache.inc, line 45

Code

function cache_set($cid, $table = 'cache', $data, $expire = CACHE_PERMANENT, $headers = NULL) {

  // Create new cache object.
  $cache = new stdClass();
  $cache->cid = $cid;
  $cache->data = $data;
  $cache->created = time();
  $cache->expire = $expire;
  $cache->headers = $headers;

  // Save to memcache
  if ($expire == CACHE_PERMANENT || $expire > time()) {
    dmemcache_set($cid, $cache, $expire, $table);
  }
  else {
    if ($expire == CACHE_TEMPORARY) {

      // A compromise for CACHE_TEMPORARY: Cache for three minutes.
      dmemcache_set($cid, $cache, 180, $table);
    }
  }
}