function cache_get
7.x cache.inc | cache_get($cid, |
6.x cache.inc | cache_get( |
6.x cache-install.inc | cache_get($key, $table = 'cache') |
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 drupal-6.x/
modules/ block/ block.module - Return all blocks in the specified region for the current user.
- book_menu_subtree_data in drupal-6.x/
modules/ book/ book.module - Get the data representing a subtree of the book hierarchy.
- check_markup in drupal-6.x/
modules/ filter/ filter.module - Run all the enabled filters on a piece of text.
- drupal_get_schema in drupal-6.x/
includes/ common.inc - Get the schema definition of a table, or the whole database schema.
- form_get_cache in drupal-6.x/
includes/ form.inc - Fetch a form from cache.
File
- drupal-6.x/
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);
}
}
// If enforcing a minimum cache lifetime, validate that the data is
// currently valid for this user before we return it by making sure the
// cache entry was created before the timestamp in the current session's
// cache timer. The cache variable is loaded into the $user object by
// sess_read() in session.inc.
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;
}