MediaWiki REL1_32
|
A cache class that replicates all writes to multiple child caches. More...
Public Member Functions | |
__construct ( $params) | |
$params include: | |
add ( $key, $value, $exptime=0) | |
clearLastError () | |
Clear the "last error" registry. | |
decr ( $key, $value=1) | |
Decrease stored value of $key by $value while preserving its TTL. | |
delete ( $key) | |
Delete an item. | |
deleteObjectsExpiringBefore ( $date, $progressCallback=false) | |
Delete objects expiring before a certain date. | |
getLastError () | |
Get the "last error" registered; clearLastError() should be called manually. | |
incr ( $key, $value=1) | |
Increase stored value of $key by $value while preserving its TTL. | |
lock ( $key, $timeout=6, $expiry=6, $rclass='') | |
Acquire an advisory lock on a key string. | |
makeGlobalKey ( $class, $component=null) | |
Make a global cache key. | |
makeKey ( $class, $component=null) | |
Make a cache key, scoped to this instance's keyspace. | |
makeKeyInternal ( $keyspace, $args) | |
Construct a cache key. | |
merge ( $key, callable $callback, $exptime=0, $attempts=10, $flags=0) | |
Merge changes into the existing cache value (possibly creating a new one) | |
set ( $key, $value, $exptime=0, $flags=0) | |
Set an item. | |
setDebug ( $debug) | |
unlock ( $key) | |
Release an advisory lock on a key string. | |
Public Member Functions inherited from BagOStuff | |
__construct (array $params=[]) | |
$params include: | |
addBusyCallback (callable $workCallback) | |
Let a callback be run to avoid wasting time on special blocking calls. | |
changeTTL ( $key, $expiry=0) | |
Reset the TTL on a key if it exists. | |
get ( $key, $flags=0, $oldFlags=null) | |
Get an item with the given key. | |
getMulti (array $keys, $flags=0) | |
Get an associative array containing the item for each of the keys that have items. | |
getQoS ( $flag) | |
getScopedLock ( $key, $timeout=6, $expiry=30, $rclass='') | |
Get a lightweight exclusive self-unlocking lock. | |
getWithSetCallback ( $key, $ttl, $callback, $flags=0) | |
Get an item with the given key, regenerating and setting it if not found. | |
incrWithInit ( $key, $ttl, $value=1, $init=1) | |
Increase stored value of $key by $value while preserving its TTL. | |
modifySimpleRelayEvent (array $event) | |
Modify a cache update operation array for EventRelayer::notify() | |
setLogger (LoggerInterface $logger) | |
setMockTime (&$time) | |
setMulti (array $data, $exptime=0) | |
Batch insertion. | |
Public Attributes | |
const | UPGRADE_TTL = 3600 |
Public Attributes inherited from BagOStuff | |
const | ERR_NO_RESPONSE = 1 |
const | ERR_NONE = 0 |
Possible values for getLastError() | |
const | ERR_UNEXPECTED = 3 |
const | ERR_UNREACHABLE = 2 |
const | READ_LATEST = 1 |
Bitfield constants for get()/getMulti() | |
const | READ_VERIFIED = 2 |
const | WRITE_CACHE_ONLY = 2 |
const | WRITE_SYNC = 1 |
Bitfield constants for set()/merge() | |
Public Attributes inherited from IExpiringStore | |
const | ATTR_EMULATION = 1 |
const | ATTR_SYNCWRITES = 2 |
const | QOS_EMULATION_SQL = 1 |
const | QOS_SYNCWRITES_BE = 2 |
const | QOS_SYNCWRITES_NONE = 1 |
const | QOS_SYNCWRITES_QC = 3 |
const | QOS_SYNCWRITES_SS = 4 |
const | QOS_UNKNOWN = INF |
const | TTL_DAY = 86400 |
const | TTL_HOUR = 3600 |
const | TTL_INDEFINITE = 0 |
const | TTL_MINUTE = 60 |
const | TTL_MONTH = 2592000 |
const | TTL_PROC_LONG = 30 |
const | TTL_PROC_SHORT = 3 |
const | TTL_SECOND = 1 |
const | TTL_WEEK = 604800 |
const | TTL_YEAR = 31536000 |
Protected Member Functions | |
doGet ( $key, $flags=0) | |
doWrite ( $indexes, $asyncWrites, $method) | |
Apply a write method to the backing caches specified by $indexes (in order) | |
Protected Member Functions inherited from BagOStuff | |
cas ( $casToken, $key, $value, $exptime=0) | |
Check and set an item. | |
convertExpiry ( $exptime) | |
Convert an optionally relative time to an absolute time. | |
convertToRelative ( $exptime) | |
Convert an optionally absolute expiry time to a relative time. | |
debug ( $text) | |
getCurrentTime () | |
getWithToken ( $key, &$casToken, $flags=0) | |
isInteger ( $value) | |
Check if a value is an integer. | |
mergeFlagMaps (array $bags) | |
Merge the flag maps of one or more BagOStuff objects into a "lowest common denominator" map. | |
mergeViaCas ( $key, $callback, $exptime=0, $attempts=10) | |
mergeViaLock ( $key, $callback, $exptime=0, $attempts=10, $flags=0) | |
setLastError ( $err) | |
Set the "last error" registry. | |
Protected Attributes | |
bool | $asyncWrites = false |
Use async secondary writes. | |
int[] | $cacheIndexes = [] |
List of all backing cache indexes. | |
BagOStuff[] | $caches |
Protected Attributes inherited from BagOStuff | |
callback null | $asyncHandler |
int[] | $attrMap = [] |
Map of (ATTR_* class constant => QOS_* class constant) | |
callable[] | $busyCallbacks = [] |
string | $keyspace = 'local' |
int | $lastError = self::ERR_NONE |
ERR_* class constant. | |
array[] | $locks = [] |
Lock tracking. | |
LoggerInterface | $logger |
int | $syncTimeout |
Seconds. | |
A cache class that replicates all writes to multiple child caches.
Reads are implemented by reading from the caches in the order they are given in the configuration until a cache gives a positive result.
Definition at line 32 of file MultiWriteBagOStuff.php.
MultiWriteBagOStuff::__construct | ( | $params | ) |
$params include:
array | $params |
InvalidArgumentException |
Definition at line 62 of file MultiWriteBagOStuff.php.
References $params, and BagOStuff\mergeFlagMaps().
MultiWriteBagOStuff::add | ( | $key, | |
$value, | |||
$exptime = 0 ) |
string | $key | |
mixed | $value | |
int | $exptime |
Reimplemented from BagOStuff.
Definition at line 146 of file MultiWriteBagOStuff.php.
References $value, and doWrite().
Referenced by MultiWriteBagOStuffTest\testDuplicateStoreAdd().
MultiWriteBagOStuff::clearLastError | ( | ) |
Clear the "last error" registry.
Reimplemented from BagOStuff.
Definition at line 205 of file MultiWriteBagOStuff.php.
MultiWriteBagOStuff::decr | ( | $key, | |
$value = 1 ) |
Decrease stored value of $key by $value while preserving its TTL.
string | $key | |
int | $value |
Reimplemented from BagOStuff.
Definition at line 170 of file MultiWriteBagOStuff.php.
MultiWriteBagOStuff::delete | ( | $key | ) |
Delete an item.
string | $key |
Reimplemented from BagOStuff.
Definition at line 142 of file MultiWriteBagOStuff.php.
References doWrite().
MultiWriteBagOStuff::deleteObjectsExpiringBefore | ( | $date, | |
$progressCallback = false ) |
Delete objects expiring before a certain date.
Succeed if any of the child caches succeed.
string | $date | |
bool | callable | $progressCallback |
Reimplemented from BagOStuff.
Definition at line 259 of file MultiWriteBagOStuff.php.
|
protected |
|
protected |
Apply a write method to the backing caches specified by $indexes (in order)
int[] | $indexes | List of backing cache indexes |
bool | $asyncWrites | |
string | $method | |
mixed | $args,... |
Definition at line 218 of file MultiWriteBagOStuff.php.
References $args, BagOStuff\$asyncHandler, $asyncWrites, $cache, BagOStuff\$logger, $ret, serialize(), unserialize(), and use.
Referenced by add(), decr(), delete(), doGet(), incr(), merge(), and set().
MultiWriteBagOStuff::getLastError | ( | ) |
Get the "last error" registered; clearLastError() should be called manually.
Reimplemented from BagOStuff.
Definition at line 201 of file MultiWriteBagOStuff.php.
MultiWriteBagOStuff::incr | ( | $key, | |
$value = 1 ) |
Increase stored value of $key by $value while preserving its TTL.
string | $key | Key to increase |
int | $value | Value to add to $key (Default 1) |
Reimplemented from BagOStuff.
Definition at line 166 of file MultiWriteBagOStuff.php.
MultiWriteBagOStuff::lock | ( | $key, | |
$timeout = 6, | |||
$expiry = 6, | |||
$rclass = '' ) |
Acquire an advisory lock on a key string.
Note that if reentry is enabled, duplicate calls ignore $expiry
string | $key | |
int | $timeout | Lock wait timeout; 0 for non-blocking [optional] |
int | $expiry | Lock expiry [optional]; 1 day maximum |
string | $rclass | Allow reentry if set and the current lock used this value |
Reimplemented from BagOStuff.
Definition at line 191 of file MultiWriteBagOStuff.php.
MultiWriteBagOStuff::makeGlobalKey | ( | $class, | |
$component = null ) |
Make a global cache key.
string | $class | Key class |
string | null | $component | [optional] Key component (starting with a key collection name) |
Reimplemented from BagOStuff.
Definition at line 278 of file MultiWriteBagOStuff.php.
Referenced by MultiWriteBagOStuffTest\testMakeGlobalKey().
MultiWriteBagOStuff::makeKey | ( | $class, | |
$component = null ) |
Make a cache key, scoped to this instance's keyspace.
string | $class | Key class |
string | null | $component | [optional] Key component (starting with a key collection name) |
Reimplemented from BagOStuff.
Definition at line 274 of file MultiWriteBagOStuff.php.
Referenced by MultiWriteBagOStuffTest\testMakeKey().
MultiWriteBagOStuff::makeKeyInternal | ( | $keyspace, | |
$args ) |
Construct a cache key.
string | $keyspace | |
array | $args |
Reimplemented from BagOStuff.
Definition at line 270 of file MultiWriteBagOStuff.php.
MultiWriteBagOStuff::merge | ( | $key, | |
callable | $callback, | ||
$exptime = 0, | |||
$attempts = 10, | |||
$flags = 0 ) |
Merge changes into the existing cache value (possibly creating a new one)
The callback function returns the new value given the current value (which will be false if not present), and takes the arguments: (this BagOStuff, cache key, current value, TTL). The TTL parameter is reference set to $exptime. It can be overriden in the callback.
string | $key | |
callable | $callback | Callback method to be executed |
int | $exptime | Either an interval in seconds or a unix timestamp for expiry |
int | $attempts | The amount of times to attempt a merge in case of failure |
int | $flags | Bitfield of BagOStuff::WRITE_* constants |
InvalidArgumentException |
Reimplemented from BagOStuff.
Definition at line 174 of file MultiWriteBagOStuff.php.
References $asyncWrites, doWrite(), false, and BagOStuff\WRITE_SYNC.
MultiWriteBagOStuff::set | ( | $key, | |
$value, | |||
$exptime = 0, | |||
$flags = 0 ) |
Set an item.
string | $key | |
mixed | $value | |
int | $exptime | Either an interval in seconds or a unix timestamp for expiry |
int | $flags | Bitfield of BagOStuff::WRITE_* constants |
Reimplemented from BagOStuff.
Definition at line 134 of file MultiWriteBagOStuff.php.
References $asyncWrites, $value, doWrite(), false, and BagOStuff\WRITE_SYNC.
MultiWriteBagOStuff::setDebug | ( | $bool | ) |
bool | $bool |
Reimplemented from BagOStuff.
Definition at line 97 of file MultiWriteBagOStuff.php.
MultiWriteBagOStuff::unlock | ( | $key | ) |
Release an advisory lock on a key string.
string | $key |
Reimplemented from BagOStuff.
Definition at line 196 of file MultiWriteBagOStuff.php.
|
protected |
Use async secondary writes.
Definition at line 36 of file MultiWriteBagOStuff.php.
|
protected |
List of all backing cache indexes.
Definition at line 38 of file MultiWriteBagOStuff.php.
|
protected |
Definition at line 34 of file MultiWriteBagOStuff.php.
const MultiWriteBagOStuff::UPGRADE_TTL = 3600 |
Definition at line 40 of file MultiWriteBagOStuff.php.