$cache

Provides easy, persistent caching of markup, strings, arrays or PageArray objects.

// Get a cache named 'foo' that lasts for 1 hour (aka 3600 seconds)
$value = $cache->get('foo', 3600, function() {
  // this is called if cache expired or does not exist,
  // so generate a new cache value here and return it
  return "This is the cached value";
});

Click any linked item for full usage details and examples. Hookable methods are indicated with the icon. In addition to those shown below, the WireCache class also inherits all the methods and properties of: Wire.

Common

Name	Return	Summary
$cache->delete() $cache->delete(string $name) $cache->delete(string $name)	`bool`	Delete/clear the cache(s) identified by given name or wildcard
$cache->deleteAll() $cache->deleteAll() $cache->deleteAll()	`int`	Delete all caches (where allowed)
$cache->deleteFor() $cache->deleteFor(string $ns) $cache->deleteFor(string $ns, string $name = '')	`bool`	Delete one or more caches in a given namespace
$cache->expireAll() $cache->expireAll() $cache->expireAll()	`int`	Deletes all caches that have expiration dates (only)
$cache->get() $cache->get($name) $cache->get($name, $expire = null, callable $func = null)	`string` `array` `PageArray` `mixed` `null`	Get data from cache with given name
$cache->getCacheModule() $cache->getCacheModule() $cache->getCacheModule()	`WireCacheInterface`	Get WireCache module that is currently being used
$cache->getFor() $cache->getFor($ns, string $name) $cache->getFor($ns, string $name, $expire = null, $func = null)	`string` `array` `PageArray` `mixed` `null`	Same as get() but with namespace
$cache->log() $cache->log() $cache->log(string $str = '', array $options = [])	`WireLog`	Save to the cache log
$cache->renderFile() $cache->renderFile(string $filename) $cache->renderFile(string $filename, $expire = null, array $options = [])	`string` `bool`	Render a file as a ProcessWire template file and cache the output
$cache->save() $cache->save(string $name, $data) $cache->save(string $name, $data, $expire = 86400)	`bool`	Save data to cache with given name
$cache->saveFor() $cache->saveFor($ns, string $name, $data) $cache->saveFor($ns, string $name, $data, $expire = 86400)	`bool`	Same as save() except with namespace
$cache->setCacheModule() $cache->setCacheModule(WireCacheInterface $module) $cache->setCacheModule(WireCacheInterface $module)	None	Set WireCache module to use for caching

Advanced

Name	Return	Summary
$cache->getInfo() $cache->getInfo() $cache->getInfo(bool $verbose = true, $names = [], $exclude = [], array $cols = [])	`array`	Get information about all the caches in this WireCache
$cache->maintenance() $cache->maintenance() $cache->maintenance($obj = null)	`bool`	Cache maintenance removes expired caches
$cache->preload() $cache->preload(array $names) $cache->preload(array $names, $expire = null)	None	Preload the given caches, so that they will be returned without query on the next get() call
$cache->preloadFor() $cache->preloadFor($ns) $cache->preloadFor($ns, $expire = null)	None	Preload all caches for the given object or namespace

Constants

These constants are used for the $expire argument of get() and save() cache methods.

Name	Return	Summary
WireCache::defaultCacheClass const	WireCacheDatabase	Default cache class
WireCache::expireDaily const	86400	Cache should expire once per day
WireCache::expireHourly const	3600	Cache should expire once per hour
WireCache::expireIgnore const	false	Ignore expiration (skips expiration check) 3.0.218+
WireCache::expireMonthly const	2419200	Cache should expire once per month
WireCache::expireNever const	2010-04-08 03:10:10	Cache should never expire (unless manually cleared).
WireCache::expireNow const	0	Cache should expire now
WireCache::expireReserved const	2010-04-08 03:10:01	Cache should never expire and should not be deleted during deleteAll() calls (for PW internal system use) Can only be deleted by delete() calls that specify it directly or match it specifically with a wildcard.
WireCache::expireSave const	2010-01-01 01:01:01	Cache should expire when a given resource (Page or Template) is saved.
WireCache::expireWeekly const	604800	Cache should expire once per week

Additional methods and properties

In addition to the methods and properties above, WireCache also inherits the methods and properties of these classes:

Wire

API reference based on ProcessWire core version 3.0.251