Class CacheEngine
Storage engine for CakePHP caching
Direct Subclasses
Package: Cake\Cache
Copyright: Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
License: License (http://www.opensource.org/licenses/mit-license.php)
Location: Cake/Cache/CacheEngine.php
Properties summary
-
$_groupPrefix
protectedstring
Contains the compiled string with all groups prefixes to be prepeded to every key in this cache engine
-
$settings
publicarray
Settings of current engine instance
Method Summary
-
clear() abstract public
Delete all keys from the cache -
clearGroup() public
Clears all values belonging to a group. Is upt to the implementing engine to decide whether actually deete the keys or just simulate it to acheive the same result.
-
decrement() abstract public
Decrement a number under the key and return decremented value -
delete() abstract public
Delete a key from the cache -
gc() public
Garbage collection -
groups() public
Does whatever initialization for each group is required and returns the
group value
for each of them, this is the token representing each group in the cache key -
increment() abstract public
Increment a number under the key and return incremented value -
init() public
Initialize the cache engine -
key() public
Generates a safe key for use with cache engine storage engines. -
read() abstract public
Read a key from the cache -
settings() public
Cache Engine settings -
write() abstract public
Write value for a key into cache
Method Detail
clear() abstract public ¶
clear( boolean $check )
Delete all keys from the cache
Parameters
- boolean $check
- if true will check expiration, otherwise delete all
Returns
True if the cache was successfully cleared, false otherwise
clearGroup() public ¶
clearGroup( string $group )
Clears all values belonging to a group. Is upt to the implementing engine to decide whether actually deete the keys or just simulate it to acheive the same result.
Parameters
- string $group
- $groups name of the group to be cleared
Returns
decrement() abstract public ¶
decrement( string $key , integer $offset = 1 )
Decrement a number under the key and return decremented value
Parameters
- string $key
- Identifier for the data
- integer $offset optional 1
- How much to subtract
Returns
incremented value, false otherwise
delete() abstract public ¶
delete( string $key )
Delete a key from the cache
Parameters
- string $key
- Identifier for the data
Returns
True if the value was successfully deleted, false if it didn't exist or couldn't be removed
gc() public ¶
gc( integer $expires = null )
Garbage collection
Permanently remove all expired and deleted data
Parameters
- integer $expires optional null
- [optional] An expires timestamp, invalidataing all data before.
groups() public ¶
groups( )
Does whatever initialization for each group is required
and returns the group value
for each of them, this is
the token representing each group in the cache key
Returns
increment() abstract public ¶
increment( string $key , integer $offset = 1 )
Increment a number under the key and return incremented value
Parameters
- string $key
- Identifier for the data
- integer $offset optional 1
- How much to add
Returns
incremented value, false otherwise
init() public ¶
init( array $settings = array() )
Initialize the cache engine
Called automatically by the cache frontend
Parameters
- array $settings optional array()
- Associative array of parameters for the engine
Returns
True if the engine has been successfully initialized, false if not
key() public ¶
key( string $key )
Generates a safe key for use with cache engine storage engines.
Parameters
- string $key
- the key passed over
Returns
string $key or false
read() abstract public ¶
read( string $key )
Read a key from the cache
Parameters
- string $key
- Identifier for the data
Returns
The cached data, or false if the data doesn't exist, has expired, or if there was an error fetching it
write() abstract public ¶
write( string $key , mixed $value , integer $duration )
Write value for a key into cache
Parameters
- string $key
- Identifier for the data
- mixed $value
- Data to be cached
- integer $duration
- How long to cache for.
Returns
True if the data was successfully cached, false on failure
Properties detail
$_groupPrefix ¶
Contains the compiled string with all groups prefixes to be prepeded to every key in this cache engine
null