Create a timed cache in Drupal

I am looking for more detailed information on how I can get the following caching behavior in Drupal 7.

I want a block that renders information I'm retrieving开发者_开发问答 from an external service. As the block is rendered for many users I do not want to continually request data from that service, but instead cache the result. However, this data is relatively frequent to change, so I'd like to retrieve the latest data every 5 or 10 minutes, then cache it again.

Does anyone know how to achieve such caching behavior without writing too much of the code oneself? I also haven't found much in terms of good documentation on how to use caching in Drupal (7), so any pointers on that are appreciated as well.

Keep in mind that cache_get() does not actually check if an item is expired or not. So you need to use:

if (($cache = cache_get('your_cache_key')) && $cache->expire >= REQUEST_TIME) {
  return $cache->data;
}

Also make sure to use the REQUEST_TIME constant rather than time() in D7.

The functions cache_set() and cache_get() are what you are looking for. cache_set() has an expire argument.

You can use them basically like this:

<?php
if ($cached_data = cache_get('your_cache_key')) {
  // Return from cache.
  return $cached_data->data;
}

// No or outdated cache entry, refresh data.
$data = _your_module_get_data_from_external_service();
// Save data in cache with 5min expiration time.
cache_set('your_cache_key', $data, 'cache', time() + 60 * 5);
return $data;
?>

Note: You can also use a different cache bin (see documentation links) but you need to create a corresponding cache table yourself as part of your schema.

I think this should be $cache->expire, not expires. I didn't have luck with this example if I'm setting REQUEST_TIME + 300 in cache_set() since $cache->expires will always be less than REQUEST_TIME. This works for me:

if (($cache = cache_get('your_cache_key', 'cache')) && (REQUEST_TIME < $cache->expire)) {
  return $cache->data;
}