Zend_Cache_Backend_Memcached Class Reference

Public Member Functions
	__construct (array $options=array())
	Constructor.
	load ($id, $doNotTestCacheValidity=false)
	Test if a cache is available for the given id and (if yes) return it (false else)
	test ($id)
	Test if a cache is available or not (for the given id)
	save ($data, $id, $tags=array(), $specificLifetime=false)
	Save some string datas into a cache record.
	remove ($id)
	Remove a cache record.
	clean ($mode=Zend_Cache::CLEANING_MODE_ALL, $tags=array())
	Clean some cache records.
	isAutomaticCleaningAvailable ()
	Return true if the automatic cleaning is available for the backend.
	setDirectives ($directives)
	Set the frontend directives.
	getIds ()
	Return an array of stored cache ids.
	getTags ()
	Return an array of stored tags.
	getIdsMatchingTags ($tags=array())
	Return an array of stored cache ids which match given tags.
	getIdsNotMatchingTags ($tags=array())
	Return an array of stored cache ids which don't match given tags.
	getIdsMatchingAnyTags ($tags=array())
	Return an array of stored cache ids which match any given tags.
	getFillingPercentage ()
	Return the filling percentage of the backend storage.
	getMetadatas ($id)
	Return an array of metadatas for the given cache id.
	touch ($id, $extraLifetime)
	Give (if possible) an extra lifetime to the given cache id.
	getCapabilities ()
	Return an associative array of capabilities (booleans) of the backend.
Public Member Functions inherited from Zend_Cache_Backend
	__construct (array $options=array())
	Constructor.
	setDirectives ($directives)
	Set the frontend directives.
	setOption ($name, $value)
	Set an option.
	getOption ($name)
	Returns an option.
	getLifetime ($specificLifetime)
	Get the life time.
	isAutomaticCleaningAvailable ()
	Return true if the automatic cleaning is available for the backend.
	getTmpDir ()
	Determine system TMP directory and detect if we have read access.

Public Attributes
const	DEFAULT_HOST = '127.0.0.1'
	Default Values.
const	DEFAULT_PORT = 11211
const	DEFAULT_PERSISTENT = true
const	DEFAULT_WEIGHT = 1
const	DEFAULT_TIMEOUT = 1
const	DEFAULT_RETRY_INTERVAL = 15
const	DEFAULT_STATUS = true
const	DEFAULT_FAILURE_CALLBACK = null
const	TAGS_UNSUPPORTED_BY_CLEAN_OF_MEMCACHED_BACKEND = 'Zend_Cache_Backend_Memcached::clean() : tags are unsupported by the Memcached backend'
	Log message.
const	TAGS_UNSUPPORTED_BY_SAVE_OF_MEMCACHED_BACKEND = 'Zend_Cache_Backend_Memcached::save() : tags are unsupported by the Memcached backend'

Protected Attributes
	$_options
	$_memcache = null
Protected Attributes inherited from Zend_Cache_Backend
	$_directives
	$_options = array()

Additional Inherited Members
Protected Member Functions inherited from Zend_Cache_Backend
	_isGoodTmpDir ($dir)
	Verify if the given temporary directory is readable and writable.
	_loggerSanity ()
	Make sure if we enable logging that the Zend_Log class is available.
	_log ($message, $priority=4)
	Log a message at the WARN (4) priority.

Constructor & Destructor Documentation

__construct

(

array

$options = array()

)

Constructor.

Parameters

array

$options

associative array of options

Exceptions

Zend_Cache_Exception

Returns

void

Member Function Documentation

clean	(		$mode = Zend_Cache::CLEANING_MODE_ALL,
			$tags = array()
	)

Clean 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

string	$mode	Clean mode
array	$tags	Array of tags

Exceptions

Zend_Cache_Exception

Returns

boolean True if no problem

Implements Zend_Cache_Backend_Interface.

getCapabilities

(

)

Return 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

array associative of with capabilities

Implements Zend_Cache_Backend_ExtendedInterface.

getFillingPercentage

(

)

Return the filling percentage of the backend storage.

Exceptions

Zend_Cache_Exception

Returns

int integer between 0 and 100

Implements Zend_Cache_Backend_ExtendedInterface.

getIds

(

)

Return an array of stored cache ids.

Returns

array array of stored cache ids (string)

Implements Zend_Cache_Backend_ExtendedInterface.

getIdsMatchingAnyTags

(

$tags = array()

)

Return an array of stored cache ids which match any given tags.

In case of multiple tags, a logical AND is made between tags

Parameters

array

$tags

array of tags

Returns

array array of any matching cache ids (string)

Implements Zend_Cache_Backend_ExtendedInterface.

getIdsMatchingTags

(

$tags = array()

)

Return an array of stored cache ids which match given tags.

In case of multiple tags, a logical AND is made between tags

Parameters

array

$tags

array of tags

Returns

array array of matching cache ids (string)

Implements Zend_Cache_Backend_ExtendedInterface.

getIdsNotMatchingTags

(

$tags = array()

)

Return 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

array

$tags

array of tags

Returns

array array of not matching cache ids (string)

Implements Zend_Cache_Backend_ExtendedInterface.

getMetadatas

(

$id

)

Return 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

string

$id

cache id

Returns

array array of metadatas (false if the cache id is not found)

Implements Zend_Cache_Backend_ExtendedInterface.

getTags

(

)

Return an array of stored tags.

Returns

array array of stored tags (string)

Implements Zend_Cache_Backend_ExtendedInterface.

isAutomaticCleaningAvailable

(

)

Return true if the automatic cleaning is available for the backend.

Returns

boolean

load	(		$id,
			$doNotTestCacheValidity = false
	)

Test if a cache is available for the given id and (if yes) return it (false else)

Parameters

string	$id	Cache id
boolean	$doNotTestCacheValidity	If set to true, the cache validity won't be tested

Returns

string|false cached datas

Implements Zend_Cache_Backend_Interface.

remove

(

$id

)

Remove a cache record.

Parameters

string

$id

Cache id

Returns

boolean True if no problem

Implements Zend_Cache_Backend_Interface.

save	(		$data,
			$id,
			$tags = array(),
			$specificLifetime = false
	)

Save some string datas into a cache record.

Note : $data is always "string" (serialization is done by the core not by the backend)

Parameters

string	$data	Datas to cache
string	$id	Cache id
array	$tags	Array of strings, the cache record will be tagged by each string entry
int	$specificLifetime	If != false, set a specific lifetime for this cache record (null => infinite lifetime)

Returns

boolean True if no problem

Implements Zend_Cache_Backend_Interface.

setDirectives

(

$directives

)

Set the frontend directives.

Parameters

array

$directives

Assoc of directives

Exceptions

Zend_Cache_Exception

Returns

void

Implements Zend_Cache_Backend_Interface.

test

(

$id

)

Test if a cache is available or not (for the given id)

Parameters

string

$id

Cache id

Returns

mixed|false (a cache is not available) or "last modified" timestamp (int) of the available cache record

Implements Zend_Cache_Backend_Interface.

touch	(		$id,
			$extraLifetime
	)

Give (if possible) an extra lifetime to the given cache id.

Parameters

string	$id	cache id
int	$extraLifetime

Returns

boolean true if ok

Implements Zend_Cache_Backend_ExtendedInterface.

Member Data Documentation

$_memcache = null

protected

$_options

protected

Initial value:

= array(
        'servers' => array(array(
            'host' => self::DEFAULT_HOST,
            'port' => self::DEFAULT_PORT,
            'persistent' => self::DEFAULT_PERSISTENT,
            'weight'  => self::DEFAULT_WEIGHT,
            'timeout' => self::DEFAULT_TIMEOUT,
            'retry_interval' => self::DEFAULT_RETRY_INTERVAL,
            'status' => self::DEFAULT_STATUS,
            'failure_callback' => self::DEFAULT_FAILURE_CALLBACK
        )),
        'compression' => false,
        'compatibility' => false,
    )

const DEFAULT_FAILURE_CALLBACK = null

const DEFAULT_HOST = '127.0.0.1'

Default Values.

const DEFAULT_PERSISTENT = true

const DEFAULT_PORT = 11211

const DEFAULT_RETRY_INTERVAL = 15

const DEFAULT_STATUS = true

const DEFAULT_TIMEOUT = 1

const DEFAULT_WEIGHT = 1

const TAGS_UNSUPPORTED_BY_CLEAN_OF_MEMCACHED_BACKEND = 'Zend_Cache_Backend_Memcached::clean() : tags are unsupported by the Memcached backend'

Log message.

const TAGS_UNSUPPORTED_BY_SAVE_OF_MEMCACHED_BACKEND = 'Zend_Cache_Backend_Memcached::save() : tags are unsupported by the Memcached backend'