function cache_set in Memcache API and Integration 5

Same name in this branch

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

Same name and namespace in other branches

1. 5.2 memcache.db.inc \cache_set()
2. 5.2 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) {
  $time = $_SERVER['REQUEST_TIME'];

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

  // Save to memcache
  if ($expire == CACHE_TEMPORARY) {
    $expire = variable_get('cache_lifetime', 2591999);
  }

  // We manually track the expire time in $cache->expire.  When the object
  // expires, we only allow one request to rebuild it to avoid cache stampedes.
  // Other requests for the expired object while it is still being rebuilt get
  // the expired object.
  dmemcache_set($cid, $cache, 0, $table);
}