function _cache_set in Memcache API and Integration 6
Store data in the persistent cache.
The persistent cache is split up into four database tables. Contributed modules can add additional tables.
'cache_page': This table stores generated pages for anonymous users. This is the only table affected by the page cache setting on the administrator panel.
'cache_menu': Stores the cachable part of the users' menus.
'cache_filter': Stores filtered pieces of content. This table is periodically cleared of stale entries by cron.
'cache': Generic cache storage table.
The reasons for having several tables are as follows:
- smaller tables allow for faster selects and inserts
- we try to put fast changing cache items and rather static ones into different tables. The effect is that only the fast changing tables will need a lot of writes to disk. The more static tables will also be better cachable with MySQL's query cache
Parameters
$cid: The cache ID of the data to store.
$data: The data to store in the cache. Complex data types will be automatically serialized before insertion. Strings will be stored as plain text and not serialized.
$table: The table $table to store the data in. Valid core values are 'cache_filter', 'cache_menu', 'cache_page', or 'cache'.
$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.
1 call to _cache_set()
- cache_set in ./
memcache.inc - Store data in memcache.
File
- ./
database.inc, line 113 - This code is copy and paste from includes/cache.inc The function names have been prefixed with underscore to avoid namespace conflicts. It is used for bins that map to 'database' for datbase fallback storage.
Code
function _cache_set($cid, $data, $table = 'cache', $expire = CACHE_PERMANENT, $headers = NULL) {
$serialized = 0;
if (is_object($data) || is_array($data)) {
$data = serialize($data);
$serialized = 1;
}
$created = time();
db_query("UPDATE {" . $table . "} SET data = %b, created = %d, expire = %d, headers = '%s', serialized = %d WHERE cid = '%s'", $data, $created, $expire, $headers, $serialized, $cid);
if (!db_affected_rows()) {
@db_query("INSERT INTO {" . $table . "} (cid, data, created, expire, headers, serialized) VALUES ('%s', %b, %d, %d, '%s', %d)", $cid, $data, $created, $expire, $headers, $serialized);
}
}