Cache/Backend/ZendServer/ShMem.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: ShMem.php 24593 2012-01-05 20:35:02Z matthew $
\Zend_Cache_Backend_ZendServer_ShMem
- Implements
- \Zend_Cache_Backend_Interface
- Parent(s)
- \Zend_Cache_Backend_ZendServer < \Zend_Cache_Backend
- 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\Zend_Cache_Backend_ZendServer::$$_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
- Inherited_from
- \Zend_Cache_Backend_ZendServer::$$_directives


array $_options = array('namespace' => 'zendframework')
Available options
<p>available options</p>Inherited from: \Zend_Cache_Backend_ZendServer::$$_options=====> (string) namespace : Namespace to be used for chaching operations
array('namespace' => 'zendframework')
Details- Type
- array
- Inherited_from
- \Zend_Cache_Backend_ZendServer::$$_options
Methods


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


_expireTime( $lifetime) : int
Compute & return the expire time
Inherited from: \Zend_Cache_Backend_ZendServer::_expireTime()Name | Type | Description |
---|---|---|
$lifetime |
Type | Description |
---|---|
int | expire time (unix timestamp) |


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


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


_log(string $message, $priority = 4) : void
Log a message at the WARN (4) priority.
Inherited from: \Zend_Cache_Backend::_log()\Zend_Cache_Backend_ZendServer::_log()Name | Type | Description |
---|---|---|
$message | string | |
$priority |
Exception | Description |
---|---|
\Zend_Cache_Exception |


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


_store(mixed $data, string $id, int $timeToLive) : void
Store 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 |


_unset(string $id) : boolean
Unset data
Name | Type | Description |
---|---|---|
$id | string | Cache id |
Type | Description |
---|---|
boolean | true if no problem |


clean(string $mode = \Zend_Cache::CLEANING_MODE_ALL, array $tags = array()) : boolean
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) Zend_Cache::CLEANING_MODE_MATCHING_ANY_TAG => remove cache entries matching any given tags ($tags can be an array of strings or a single string)
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
Get the life time
Inherited from: \Zend_Cache_Backend::getLifetime()\Zend_Cache_Backend_ZendServer::getLifetime()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
Returns an option
Inherited from: \Zend_Cache_Backend::getOption()\Zend_Cache_Backend_ZendServer::getOption()Name | Type | Description |
---|---|---|
$name | string | Optional, the options name to return |
Type | Description |
---|---|
mixed |
Exception | Description |
---|---|
\Zend_Cache_Exceptions |


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


isAutomaticCleaningAvailable() : boolean
Return true if the automatic cleaning is available for the backend
Inherited from: \Zend_Cache_Backend::isAutomaticCleaningAvailable()\Zend_Cache_Backend_ZendServer::isAutomaticCleaningAvailable()DEPRECATED : use getCapabilities() instead
Type | Description |
---|---|
boolean |


load(string $id, boolean $doNotTestCacheValidity = false) : string | false
Test if a cache is available for the given id and (if yes) return it (false else)
Inherited from: \Zend_Cache_Backend_Interface::load()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 | false | cached datas |


remove(string $id) : boolean
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) : boolean
Save some string datas into a cache record
Inherited from: \Zend_Cache_Backend_Interface::save()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
Set an option
Inherited from: \Zend_Cache_Backend::setOption()\Zend_Cache_Backend_ZendServer::setOption()Name | Type | Description |
---|---|---|
$name | string | |
$value | mixed |
Exception | Description |
---|---|
\Zend_Cache_Exception |


test(string $id) : mixed | false
Test if a cache is available or not (for the given id)
Inherited from: \Zend_Cache_Backend_Interface::test()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 |