function cache_clear_all

Expires data from the cache.

If called with the arguments $cid and $bin set to NULL or omitted, then expirable entries will be cleared from the cache_page and cache_block bins, and the $wildcard argument is ignored.

Parameters

$cid: If set, the cache ID or an array of cache IDs. Otherwise, all cache entries that can expire are deleted. The $wildcard argument will be ignored if set to NULL.

$bin: If set, the cache bin to delete from. Mandatory argument if $cid is set.

$wildcard: If TRUE, the $cid argument must contain a string value and cache IDs starting with $cid are deleted in addition to the exact cache ID specified by $cid. If $wildcard is TRUE and $cid is '*', the entire cache is emptied.

File

includes/cache.inc, line 163

Functions and interfaces for cache handling.

Code

function cache_clear_all($cid = NULL, $bin = NULL, $wildcard = FALSE) {
  if (!isset($cid) && !isset($bin)) {

    // Clear the block cache first, so stale data will
    // not end up in the page cache.
    if (module_exists('block')) {
      cache_clear_all(NULL, 'cache_block');
    }
    cache_clear_all(NULL, 'cache_page');
    return;
  }
  return _cache_get_object($bin)
    ->clear($cid, $wildcard);
}

Comments

You may be looking for this...

MichaelCole commented 19 March 2011 at 03:17

drupal_flush_all_caches:

http://api.drupal.org/api/drupal/includes--common.inc/function/drupal_fl...

drupal_flush_all_caches() calls cache_clear_all()

Elijah Lynn commented 21 June 2016 at 16:46

In addition it is worth noting that drupal_flush_all_caches() calls cache_clear_all().

Not sure what happened to link above but this one currently works https://api.drupal.org/api/drupal/includes%21common.inc/function/drupal_...

$bin == cache table

jyee commented 3 January 2012 at 19:47

The $bin is the name of the particular database cache table. So, for example:
cache_clear_all('field:node:' . $node->nid, 'cache_field');

Speeding up cache

AlexBorsody commented 2 July 2012 at 14:16

I built a custom module that allows the user to upload an image and then clears the cache to display the image on the page. the process takes a very long time, as the image must be uploaded then the cache cleared. right now I am using cache_clear_all but is there a way to only clear the cache for images?

		node_save($node);
		unset($node);
		$GLOBALS['conf']['cache'] = 0;
		drupal_flush_all_caches();
		cache_clear_all(NULL, 'cache_page', '*');

If you'd like to clear an

geerlingguy commented 2 August 2013 at 16:57

If you'd like to clear an entire cache bin for database caches, regardless of the 'expire' value for a cached object, you need to do something like:

cache_clear_all('*', 'cache_my_module_bin', TRUE);

Providing an '*' for the first parameter tells the database cache interface's clear() method to truncate the particular cache bin.

Drupal 8

bwaindwain commented 18 November 2019 at 20:39

Use the new cache API https://www.drupal.org/node/1272696