Cache/Backend/ZendServer/Disk.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: Disk.php 24593 2012-01-05 20:35:02Z matthew $
\Zend_Cache_Backend_ZendServer_Disk
- 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()) : voidConstructor
| Name | Type | Description |
|---|---|---|
| $options | array | associative array of options |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |

_expireTime( $lifetime) : intCompute & 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) : 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()\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) : voidLog 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() : voidMake 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) : booleanStore data
| Name | Type | Description |
|---|---|---|
| $data | mixed | Object to store |
| $id | string | Cache id |
| $timeToLive | int | Time to live in seconds |
| Type | Description |
|---|---|
| boolean | true if no problem |
| Exception | Description |
|---|---|
| \Zend_Cache_Exception |

_unset(string $id) : booleanUnset 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) : intGet 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) : mixedReturns 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() : stringDetermine 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() : booleanReturn 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 | falseTest 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) : booleanSave 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) : voidSet 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 | falseTest 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 |