Cache/Backend/Test.php
Show:
inherited
inherited
Classes
Zend Framework
LICENSE
This source file is subject to the new BSD license that is bundled
with this package in the file LICENSE.txt.
It is also available through the world-wide-web at this URL:
http://framework.zend.com/license/new-bsd
If you did not receive a copy of the license and are unable to
obtain it through the world-wide-web, please send an email
to license@zend.com so we can send you a copy immediately.
- Category
- Zend
- Copyright
- Copyright (c) 2005-2014 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
- Package
- Zend_Cache
- Subpackage
- Zend_Cache_Backend
- Version
- $Id$
\Zend_Cache_Backend_Test
Package: Zend_Cache\Zend_Cache_Backend
Returns
Returns
Returns
Returns
Returns
Returns
Returns
Returns
Returns
- Implements
- Parent(s)
- \Zend_Cache_Backend
- Copyright
- Copyright (c) 2005-2014 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
Properties
array $_directives = array()Frontend or Core directives
Default value
array()Details- Type
- array
int $_index = 0Current index for log array
Default value
0Details- Type
- int
array $_log = array()Array to log actions
Default value
array()Details- Type
- array
array $_options = array()Available options
Default value
array()Details- Type
- array
Methods
__construct(array $options = array()) : voidConstructor
Parameters
| Name | Type | Description |
|---|---|---|
| $options | array | associative array of options |
_addLog(string $methodName, array $args) : voidAdd an event to the log array
Parameters
| Name | Type | Description |
|---|---|---|
| $methodName | string | MethodName |
| $args | array | Arguments |
clean(string $mode = \Zend_Cache::CLEANING_MODE_ALL, array $tags = array()) : booleanClean some cache records
For this test backend only, if $mode == 'false', then the method will return false
(true else)
Available modes are :
Zend_Cache::CLEANING_MODE_ALL (default) => remove all cache entries ($tags is not used)
Zend_Cache::CLEANING_MODE_OLD => remove too old cache entries ($tags is not used)
Zend_Cache::CLEANING_MODE_MATCHING_TAG => remove cache entries matching all given tags
($tags can be an array of strings or a single string)
Zend_Cache::CLEANING_MODE_NOT_MATCHING_TAG => remove cache entries not {matching one of the given tags}
($tags can be an array of strings or a single string)
Parameters| Name | Type | Description |
|---|---|---|
| $mode | string | Clean mode |
| $tags | array | Array of tags |
| Type | Description |
|---|---|
| boolean | True if no problem |
getAllLogs() : arrayGet the complete log array
Returns
| Type | Description |
|---|---|
| array | Complete log array |
getCapabilities() : arrayReturn an associative array of capabilities (booleans) of the backend
The array must include these keys :
- automatic_cleaning (is automating cleaning necessary)
- tags (are tags supported)
- expired_read (is it possible to read expired cache records
(for doNotTestCacheValidity option for example))
- priority does the backend deal with priority when saving
- infinite_lifetime (is infinite lifetime can work with this backend)
- get_list (is it possible to get the list of cache ids and the complete list of tags)
Returns| Type | Description |
|---|---|
| array | associative of with capabilities |
getFillingPercentage() : intReturn the filling percentage of the backend storage
Returns
| Type | Description |
|---|---|
| int | integer between 0 and 100 |
getIds() : arrayReturn an array of stored cache ids
Returns
| Type | Description |
|---|---|
| array | array of stored cache ids (string) |
getIdsMatchingAnyTags(array $tags = array()) : arrayReturn an array of stored cache ids which match any given tags
In case of multiple tags, a logical AND is made between tags
Parameters| Name | Type | Description |
|---|---|---|
| $tags | array | array of tags |
| Type | Description |
|---|---|
| array | array of any matching cache ids (string) |
getIdsMatchingTags(array $tags = array()) : arrayReturn an array of stored cache ids which match given tags
In case of multiple tags, a logical AND is made between tags
Parameters| Name | Type | Description |
|---|---|---|
| $tags | array | array of tags |
| Type | Description |
|---|---|
| array | array of matching cache ids (string) |
getIdsNotMatchingTags(array $tags = array()) : arrayReturn an array of stored cache ids which don't match given tags
In case of multiple tags, a logical OR is made between tags
Parameters| Name | Type | Description |
|---|---|---|
| $tags | array | array of tags |
| Type | Description |
|---|---|
| array | array of not matching cache ids (string) |
getLastLog() : stringGet the last log
Returns
| Type | Description |
|---|---|
| string | The last log |
getLogIndex() : intGet the log index
Returns
| Type | Description |
|---|---|
| int | Log index |
getMetadatas(string $id) : arrayReturn an array of metadatas for the given cache id
The array must include these keys :
- expire : the expire timestamp
- tags : a string array of tags
- mtime : timestamp of last modification time
Parameters| Name | Type | Description |
|---|---|---|
| $id | string | cache id |
| Type | Description |
|---|---|
| array | array of metadatas (false if the cache id is not found) |
getTags() : arrayReturn an array of stored tags
Returns
| Type | Description |
|---|---|
| array | array of stored tags (string) |
isAutomaticCleaningAvailable() : booleanReturn true if the automatic cleaning is available for the backend
Returns
| Type | Description |
|---|---|
| boolean |
load(string $id, boolean $doNotTestCacheValidity = false) : stringTest if a cache is available for the given id and (if yes) return it (false else)
For this test backend only, if $id == 'false', then the method will return false
if $id == 'serialized', the method will return a serialized array
('foo' else)
Parameters| Name | Type | Description |
|---|---|---|
| $id | string | Cache id |
| $doNotTestCacheValidity | boolean | If set to true, the cache validity won't be tested |
| Type | Description |
|---|---|
| string | Cached datas (or false) |
remove(string $id) : booleanRemove a cache record
For this test backend only, if $id == 'false', then the method will return false
(true else)
Parameters| Name | Type | Description |
|---|---|---|
| $id | string | Cache id |
| Type | Description |
|---|---|
| boolean | True if no problem |
save(string $data, string $id, array $tags = array(), int $specificLifetime = false) : booleanSave some string datas into a cache record
For this test backend only, if $id == 'false', then the method will return false
(true else)
Parameters| Name | Type | Description |
|---|---|---|
| $data | string | Datas to cache |
| $id | string | Cache id |
| $tags | array | Array of strings, the cache record will be tagged by each string entry |
| $specificLifetime | int | If != false, set a specific lifetime for this cache record (null => infinite lifetime) |
| Type | Description |
|---|---|
| boolean | True if no problem |
setDirectives(array $directives) : voidSet the frontend directives
Parameters
| Name | Type | Description |
|---|---|---|
| $directives | array | assoc of directives |
test(string $id) : mixed | falseTest if a cache is available or not (for the given id)
For this test backend only, if $id == 'false', then the method will return false
(123456 else)
Parameters| Name | Type | Description |
|---|---|---|
| $id | string | Cache id |
| Type | Description |
|---|---|
| mixed | false | false (a cache is not available) or "last modified" timestamp (int) of the available cache record |
touch(string $id, int $extraLifetime) : booleanGive (if possible) an extra lifetime to the given cache id
Parameters
Returns
| Name | Type | Description |
|---|---|---|
| $id | string | cache id |
| $extraLifetime | int |
| Type | Description |
|---|---|
| boolean | true if ok |