API Documentation

Cache/Backend/Apc.php

Includes Classes 
category
Zend
copyright
Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
license
http://framework.zend.com/license/new-bsd New BSD License
package
Zend_Cache
subpackage
Zend_Cache_Backend
version
$Id: Apc.php 20096 2010-01-06 02:05:09Z bkarwin $
Classes
Zend_Cache_Backend_Apc

Description

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 license@zend.com so we can send you a copy immediately.

Zend_Cache_Backend_Apc
jump to top

Extends from
Zend_Cache_Backend
Implements
Zend_Cache_Backend_ExtendedInterface
copyright
Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
license
http://framework.zend.com/license/new-bsd New BSD License
package
Zend_Cache
subpackage
Zend_Cache_Backend
Constants
TAGS_UNSUPPORTED_BY_CLEAN_OF_APC_BACKEND
TAGS_UNSUPPORTED_BY_SAVE_OF_APC_BACKEND
Methods
__construct
load
test
save
remove
clean
isAutomaticCleaningAvailable
getFillingPercentage
getTags
getIdsMatchingTags
getIdsNotMatchingTags
getIdsMatchingAnyTags
getIds
getMetadatas
touch
getCapabilities

Description

Constants

TAGS_UNSUPPORTED_BY_CLEAN_OF_APC_BACKEND
jump to class

 TAGS_UNSUPPORTED_BY_CLEAN_OF_APC_BACKEND = 'Zend_Cache_Backend_Apc::clean() : tags are unsupported by the Apc backend'

Log message

Details

value
Zend_Cache_Backend_Apc::clean() : tags are unsupported by the Apc backend

TAGS_UNSUPPORTED_BY_SAVE_OF_APC_BACKEND
jump to class

 TAGS_UNSUPPORTED_BY_SAVE_OF_APC_BACKEND = 'Zend_Cache_Backend_Apc::save() : tags are unsupported by the Apc backend'

Details

value
Zend_Cache_Backend_Apc::save() : tags are unsupported by the Apc backend

Methods

__construct
jump to class

__construct( array $options = array ) : void

Constructor

Arguments
$options
array
associative array of options
Details
visibility
public
final
false
static
false
throws

clean
jump to class

clean( string $mode = Zend_Cache, array $tags = array ) : boolean

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

Arguments
$mode
string
clean mode
$tags
array
array of tags
Output
boolean
true if no problem
Details
visibility
public
final
false
static
false
throws

getCapabilities
jump to class

getCapabilities( ) : array

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)

Output
array
associative of with capabilities
Details
visibility
public
final
false
static
false

getFillingPercentage
jump to class

getFillingPercentage( ) : int

Return the filling percentage of the backend storage

Output
int
integer between 0 and 100
Details
visibility
public
final
false
static
false
throws

getIds
jump to class

getIds( ) : array

Return an array of stored cache ids

Output
array
array of stored cache ids (string)
Details
visibility
public
final
false
static
false

getIdsMatchingAnyTags
jump to class

getIdsMatchingAnyTags( array $tags = array ) : 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

Arguments
$tags
array
array of tags
Output
array
array of any matching cache ids (string)
Details
visibility
public
final
false
static
false

getIdsMatchingTags
jump to class

getIdsMatchingTags( array $tags = array ) : array

Return an array of stored cache ids which match given tags

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

Arguments
$tags
array
array of tags
Output
array
array of matching cache ids (string)
Details
visibility
public
final
false
static
false

getIdsNotMatchingTags
jump to class

getIdsNotMatchingTags( array $tags = array ) : 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

Arguments
$tags
array
array of tags
Output
array
array of not matching cache ids (string)
Details
visibility
public
final
false
static
false

getMetadatas
jump to class

getMetadatas( string $id ) : array

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

Arguments
$id
string
cache id
Output
array
array of metadatas (false if the cache id is not found)
Details
visibility
public
final
false
static
false

getTags
jump to class

getTags( ) : array

Return an array of stored tags

Output
array
array of stored tags (string)
Details
visibility
public
final
false
static
false

isAutomaticCleaningAvailable
jump to class

isAutomaticCleaningAvailable( ) : boolean

Return true if the automatic cleaning is available for the backend

DEPRECATED : use getCapabilities() instead

Output
boolean
Details
visibility
public
final
false
static
false
deprecated

load
jump to class

load( string $id, boolean $doNotTestCacheValidity = false ) : string

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

WARNING $doNotTestCacheValidity=true is unsupported by the Apc backend

Arguments
$id
string
cache id
$doNotTestCacheValidity
boolean
if set to true, the cache validity won't be tested
Output
string
cached datas (or false)
Details
visibility
public
final
false
static
false

remove
jump to class

remove( string $id ) : boolean

Remove a cache record

Arguments
$id
string
cache id
Output
boolean
true if no problem
Details
visibility
public
final
false
static
false

save
jump to class

save( string $data, string $id, array $tags = array, int $specificLifetime = false ) : boolean

Save some string datas into a cache record

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

Arguments
$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)
Output
boolean
true if no problem
Details
visibility
public
final
false
static
false

test
jump to class

test( string $id ) : mixed

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

Arguments
$id
string
cache id
Output
mixed
false (a cache is not available) or "last modified" timestamp (int) of the available cache record
Details
visibility
public
final
false
static
false

touch
jump to class

touch( string $id, int $extraLifetime ) : boolean

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

Arguments
$id
string
cache id
$extraLifetime
int
Output
boolean
true if ok
Details
visibility
public
final
false
static
false
Documentation was generated by DocBlox.