Cache/Backend/ZendServer.php
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-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
- Package
- Zend_Cache
- Subpackage
- Zend_Cache_Backend
- Version
- $Id: ZendServer.php 24593 2012-01-05 20:35:02Z matthew $
\Zend_Cache_Backend_ZendServer
- Implements
- \Zend_Cache_Backend_Interface
- Parent(s)
- \Zend_Cache_Backend
- Children
- \Zend_Cache_Backend_ZendServer_Disk
- \Zend_Cache_Backend_ZendServer_ShMem
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
Properties

array $_directives = array('lifetime' => 3600, 'logging' => false, 'logger' => null)Frontend or Core directives
<p>directives</p>Inherited from: \Zend_Cache_Backend::$$_directives=====> (int) lifetime : - Cache lifetime (in seconds) - If null, the cache is valid forever
=====> (int) logging : - if set to true, a logging is activated throw Zend_Log
array('lifetime' => 3600, 'logging' => false, 'logger' => null)Details- Type
- array
- Inherited_from
- \Zend_Cache_Backend::$$_directives
Methods

__construct(array $options = array()) : void
| Name | Type | Description |
|---|---|---|
| $options | array | Associative array of options |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |

_expireTime( $lifetime) : intCompute & return the expire time
| Name | Type | Description |
|---|---|---|
| $lifetime |
| Type | Description |
|---|---|
| int | expire time (unix timestamp) |

_fetch(string $id) : voidFetch data
| Name | Type | Description |
|---|---|---|
| $id | string | Cache id |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |

_isGoodTmpDir(string $dir) : booleanVerify if the given temporary directory is readable and writable
Inherited from: \Zend_Cache_Backend::_isGoodTmpDir()| Name | Type | Description |
|---|---|---|
| $dir | string | temporary directory |
| Type | Description |
|---|---|
| boolean | true if the directory is ok |

_log(string $message, $priority = 4) : void
| Name | Type | Description |
|---|---|---|
| $message | string | |
| $priority |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |

_loggerSanity() : voidMake sure if we enable logging that the Zend_Log class is available.
Inherited from: \Zend_Cache_Backend::_loggerSanity()Create a default log object if none is set.
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |

_store(mixed $data, string $id, int $timeToLive) : voidStore data
| Name | Type | Description |
|---|---|---|
| $data | mixed | Object to store |
| $id | string | Cache id |
| $timeToLive | int | Time to live in seconds |
| 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
| Name | Type | Description |
|---|---|---|
| $mode | string | clean mode |
| $tags | array | array of tags |
| Type | Description |
|---|---|
| boolean | true if no problem |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |

getLifetime(int $specificLifetime) : int
if $specificLifetime is not false, the given specific life time is used else, the global lifetime is used
| Name | Type | Description |
|---|---|---|
| $specificLifetime | int |
| Type | Description |
|---|---|
| int | Cache life time |

getOption(string $name) : mixed
| Name | Type | Description |
|---|---|---|
| $name | string | Optional, the options name to return |
| Type | Description |
|---|---|
| mixed |
| Exception | Description |
|---|---|
| \Zend_Cache_Exceptions |

getTmpDir() : stringDetermine system TMP directory and detect if we have read access
Inherited from: \Zend_Cache_Backend::getTmpDir()inspired from Zend_File_Transfer_Adapter_Abstract
| Type | Description |
|---|---|
| string |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception | if unable to determine directory |

isAutomaticCleaningAvailable() : booleanReturn true if the automatic cleaning is available for the backend
Inherited from: \Zend_Cache_Backend::isAutomaticCleaningAvailable()DEPRECATED : use getCapabilities() instead
| 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)
Note : return value is always "string" (unserialization is done by the core not by the backend)
| 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
| 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)
| 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) : void
| Name | Type | Description |
|---|---|---|
| $directives | array | assoc of directives |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |

setOption(string $name, mixed $value) : void
| Name | Type | Description |
|---|---|---|
| $name | string | |
| $value | mixed |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |

test(string $id) : mixedTest if a cache is available or not (for the given id)
| 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 |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |