Craft 2 Class Reference

Class CacheService

Package
craft.app.services
Namespace
Craft
Inheritance
class CacheService » BaseApplicationComponent » \CApplicationComponent » \CComponent
Implements
\IApplicationComponent
Since
2.0
Source Code
craft/app/services/CacheService.php

Class CacheService

Public Properties
Property Type Description Defined By
behaviors array the behaviors that should be attached to this component. \CApplicationComponent
isInitialized bool Checks if this application component has been initialized. \CApplicationComponent
Public Methods
Method Description Defined By
__call() Calls the named method which is not a class method. \CComponent
__get() Returns a property value, an event handler list or a behavior based on its name. \CComponent
__isset() Checks if a property value is null. \CComponent
__set() Sets value of a component property. \CComponent
__unset() Sets a component property to be null. \CComponent
add() Stores a value identified by a key into cache if the cache does not contain this key. Nothing will be done if the cache already contains the key. CacheService
asa() Returns the named behavior object. \CComponent
attachBehavior() Attaches a behavior to this component. \CComponent
attachBehaviors() Attaches a list of behaviors to the component. \CComponent
attachEventHandler() Attaches an event handler to an event. \CComponent
canGetProperty() Determines whether a property can be read. \CComponent
canSetProperty() Determines whether a property can be set. \CComponent
delete() Deletes a value with the specified key from cache. CacheService
detachBehavior() Detaches a behavior from the component. \CComponent
detachBehaviors() Detaches all behaviors from the component. \CComponent
detachEventHandler() Detaches an existing event handler. \CComponent
disableBehavior() Disables an attached behavior. \CComponent
disableBehaviors() Disables all behaviors attached to this component. \CComponent
enableBehavior() Enables an attached behavior. \CComponent
enableBehaviors() Enables all behaviors attached to this component. \CComponent
evaluateExpression() Evaluates a PHP expression or callback under the context of this component. \CComponent
flush() Deletes all values from cache. Be careful of performing this operation if the cache is shared by multiple applications. CacheService
get() Retrieves a value from cache with a specified key. CacheService
getEventHandlers() Returns the list of attached event handlers for an event. \CComponent
getIsInitialized() Checks if this application component has been initialized. \CApplicationComponent
hasEvent() Determines whether an event is defined. \CComponent
hasEventHandler() Checks whether the named event has attached handlers. \CComponent
hasProperty() Determines whether a property is defined. \CComponent
init() Do the ole' craft()->cache switcharoo. CacheService
isInitialized() Checks if this application component has been initialized yet, or not. BaseApplicationComponent
mget() Retrieves multiple values from cache with the specified keys. Some caches (such as memcache, apc) allow retrieving multiple cached values at one time, which may improve the performance since it reduces the communication cost. In case a cache does not support this feature natively, it will be simulated by this method. CacheService
raiseEvent() Raises an event. \CComponent
set() Stores a value identified by a key into cache. If the cache already contains such a key, the existing value and expiration time will be replaced with the new ones. CacheService

Method Details

add() public method #

Stores a value identified by a key into cache if the cache does not contain this key. Nothing will be done if the cache already contains the key.

public bool add(string $id, mixed $value, int $expire = null, \ICacheDependency $dependency = null)
$id string The key identifying the value to be cached.
$value mixed The value to be cached.
$expire int The number of seconds in which the cached value will expire. 0 means never expire.
$dependency \ICacheDependency Dependency of the cached item. If the dependency changes, the item is labeled invalid.
Returns bool true if the value is successfully stored into cache, false otherwise.

delete() public method #

Deletes a value with the specified key from cache.

public bool delete(string $id)
$id string The key of the value to be deleted.
Returns bool If no error happens during deletion.

flush() public method #

Deletes all values from cache. Be careful of performing this operation if the cache is shared by multiple applications.

public bool flush()
Returns bool Whether the flush operation was successful.

get() public method #

Retrieves a value from cache with a specified key.

public mixed get(string $id)
$id string A key identifying the cached value
Returns mixed The value stored in cache, false if the value is not in the cache, expired if the dependency has changed.

init() public method #

Do the ole' craft()->cache switcharoo.

public null init()

mget() public method #

Retrieves multiple values from cache with the specified keys. Some caches (such as memcache, apc) allow retrieving multiple cached values at one time, which may improve the performance since it reduces the communication cost. In case a cache does not support this feature natively, it will be simulated by this method.

public array mget(array $ids)
$ids array The list of keys identifying the cached values
Returns array The list of cached values corresponding to the specified keys. The array is returned in terms of (key,value) pairs. If a value is not cached or expired, the corresponding array value will be false.

set() public method #

Stores a value identified by a key into cache. If the cache already contains such a key, the existing value and expiration time will be replaced with the new ones.

public bool set(string $id, mixed $value, int $expire = null, \ICacheDependency $dependency = null)
$id string The key identifying the value to be cached.
$value mixed The value to be cached.
$expire int The number of seconds in which the cached value will expire. Pass 0 to have the value never expire, and null to use the ‘cacheDuration’ config setting. (Default value is null.)
$dependency \ICacheDependency Dependency of the cached item. If the dependency changes, the item is labeled invalid.
Returns bool true if the value is successfully stored into cache, false otherwise.