function cache_get in Drupal 6

Same name in this branch

1. 6 includes/cache.inc \cache_get()
2. 6 includes/cache-install.inc \cache_get()

Same name and namespace in other branches

1. 4 includes/bootstrap.inc \cache_get()
2. 5 includes/cache.inc \cache_get()
3. 7 includes/cache.inc \cache_get()

Return data from the persistent cache. Data may be stored as either plain text or as serialized data. cache_get will automatically return unserialized objects and arrays.

Parameters

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

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

@see cache_set()

11 calls to cache_get()

block_list in modules/block/block.module

Return all blocks in the specified region for the current user.

book_menu_subtree_data in modules/book/book.module

Get the data representing a subtree of the book hierarchy.

check_markup in modules/filter/filter.module

Run all the enabled filters on a piece of text.

drupal_get_schema in includes/common.inc

Get the schema definition of a table, or the whole database schema.

form_get_cache in includes/form.inc

Fetch a form from cache.

... See full list

File

includes/cache.inc, line 15

Code

function cache_get($cid, $table = 'cache') {
  global $user;

  // Garbage collection necessary when enforcing a minimum cache lifetime
  $cache_flush = variable_get('cache_flush_' . $table, 0);
  if ($cache_flush && $cache_flush + variable_get('cache_lifetime', 0) <= time()) {

    // Reset the variable immediately to prevent a meltdown in heavy load situations.
    variable_set('cache_flush_' . $table, 0);

    // Time to flush old cache data
    db_query("DELETE FROM {" . $table . "} WHERE expire != %d AND expire <= %d", CACHE_PERMANENT, $cache_flush);
  }
  $cache = db_fetch_object(db_query("SELECT data, created, headers, expire, serialized FROM {" . $table . "} WHERE cid = '%s'", $cid));
  if (isset($cache->data)) {

    // If the data is permanent or we're not enforcing a minimum cache lifetime
    // always return the cached data.
    if ($cache->expire == CACHE_PERMANENT || !variable_get('cache_lifetime', 0)) {
      $cache->data = db_decode_blob($cache->data);
      if ($cache->serialized) {
        $cache->data = unserialize($cache->data);
      }
    }
    else {
      if (isset($user->cache) && $user->cache > $cache->created) {

        // This cache data is too old and thus not valid for us, ignore it.
        return 0;
      }
      else {
        $cache->data = db_decode_blob($cache->data);
        if ($cache->serialized) {
          $cache->data = unserialize($cache->data);
        }
      }
    }
    return $cache;
  }
  return 0;
}