Cache/Backend/WinCache.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 [email protected] 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_WinCache
Package: Zend_Cache\Zend_Cache_Backend
Returns
Throws
Returns
Returns
Returns
Returns
Details
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
Constants
TAGS_UNSUPPORTED_BY_CLEAN_OF_WINCACHE_BACKEND
= 'Zend_Cache_Backend_WinCache::clean() : tags are unsupported by the WinCache backend'Log message
TAGS_UNSUPPORTED_BY_SAVE_OF_WINCACHE_BACKEND
= 'Zend_Cache_Backend_WinCache::save() : tags are unsupported by the WinCache backend'Methods
__construct(array $options = array()) : voidConstructor
Parameters
Throws
| Name | Type | Description |
|---|---|---|
| $options | array | associative array of options |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |
clean(string $mode = \Zend_Cache::CLEANING_MODE_ALL, array $tags = array()) : booleanClean some cache records
Available modes are :
'all' (default) => remove all cache entries ($tags is not used)
'old' => unsupported
'matchingTag' => unsupported
'notMatchingTag' => unsupported
'matchingAnyTag' => unsupported
Parameters| Name | Type | Description |
|---|---|---|
| $mode | string | clean mode |
| $tags | array | array of tags |
| Type | Description |
|---|---|
| boolean | true if no problem |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |
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
Throws
| Type | Description |
|---|---|
| int | integer between 0 and 100 |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |
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) |
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
DEPRECATED : use getCapabilities() instead
Returns| Type | Description |
|---|---|
| boolean |
- Deprecated
load(string $id, boolean $doNotTestCacheValidity = false) : stringTest if a cache is available for the given id and (if yes) return it (false else)
WARNING $doNotTestCacheValidity=true is unsupported by the WinCache backend
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
Parameters
Returns
| 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
Note : $data is always "string" (serialization is done by the
core not by the backend)
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 |
test(string $id) : mixedTest if a cache is available or not (for the given id)
Parameters
Returns
| Name | Type | Description |
|---|---|---|
| $id | string | cache id |
| Type | Description |
|---|---|
| mixed | 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 |