Base class for memcached clients. More...

Inheritance diagram for MemcachedBagOStuff:

[legend]

Collaboration diagram for MemcachedBagOStuff:

[legend]

Public Member Functions
	__construct (array $params)

	makeKeyInternal ( $keyspace, $args)
	Construct a cache key. More...

	validateKeyEncoding ( $key)
	Ensure that a key is safe to use (contains no control characters and no characters above the ASCII range.) More...

Public Member Functions inherited from MediumSpecificBagOStuff
	add ( $key, $value, $exptime=0, $flags=0)
	Insert an item if it does not already exist. More...

	addBusyCallback (callable $workCallback)
	Let a callback be run to avoid wasting time on special blocking calls. More...

	changeTTL ( $key, $exptime=0, $flags=0)
	Change the expiration on a key if it exists. More...

	changeTTLMulti (array $keys, $exptime, $flags=0)
	Change the expiration of multiple keys that exist. More...

	clearLastError ()
	Clear the "last error" registry. More...

	delete ( $key, $flags=0)
	Delete an item. More...

	deleteMulti (array $keys, $flags=0)
	Batch deletion. More...

	deleteObjectsExpiringBefore ( $timestamp, callable $progress=null, $limit=INF)
	Delete all objects expiring before a certain date. More...

	get ( $key, $flags=0)
	Get an item with the given key. More...

	getLastError ()
	Get the "last error" registered; clearLastError() should be called manually. More...

	getMulti (array $keys, $flags=0)
	Get an associative array containing the item for each of the keys that have items. More...

	getQoS ( $flag)

	getSegmentationSize ()

	getSegmentedValueMaxSize ()

	incrWithInit ( $key, $exptime, $value=1, $init=null, $flags=0)
	Increase the value of the given key (no TTL change) if it exists or create it otherwise. More...

	lock ( $key, $timeout=6, $expiry=6, $rclass='')
	Acquire an advisory lock on a key string. More...

	makeGlobalKey ( $class,... $components)
	Make a global cache key. More...

	makeKey ( $class,... $components)
	Make a cache key, scoped to this instance's keyspace. More...

	merge ( $key, callable $callback, $exptime=0, $attempts=10, $flags=0)
	Merge changes into the existing cache value (possibly creating a new one) More...

	set ( $key, $value, $exptime=0, $flags=0)
	Set an item. More...

	setMulti (array $data, $exptime=0, $flags=0)
	Batch insertion/replace. More...

	setNewPreparedValues (array $valueByKey)
	Prepare values for storage and get their serialized sizes, or, estimate those sizes. More...

	unlock ( $key)
	Release an advisory lock on a key string. More...

Public Member Functions inherited from BagOStuff
	decr ( $key, $value=1, $flags=0)
	Decrease stored value of $key by $value while preserving its TTL. More...

	getCurrentTime ()

	getLogger ()

	getScopedLock ( $key, $timeout=6, $expiry=30, $rclass='')
	Get a lightweight exclusive self-unlocking lock. More...

	getWithSetCallback ( $key, $exptime, $callback, $flags=0)
	Get an item with the given key, regenerating and setting it if not found. More...

	incr ( $key, $value=1, $flags=0)
	Increase stored value of $key by $value while preserving its TTL. More...

	setDebug ( $enabled)

	setLogger (LoggerInterface $logger)

	setMockTime (&$time)

Protected Member Functions
	fixExpiry ( $exptime)

Protected Member Functions inherited from MediumSpecificBagOStuff
	cas ( $casToken, $key, $value, $exptime=0, $flags=0)
	Check and set an item. More...

	debug ( $text)

	doAdd ( $key, $value, $exptime=0, $flags=0)
	Insert an item if it does not already exist. More...

	doCas ( $casToken, $key, $value, $exptime=0, $flags=0)
	Check and set an item. More...

	doChangeTTL ( $key, $exptime, $flags)

	doDelete ( $key, $flags=0)
	Delete an item. More...

	doDeleteMulti (array $keys, $flags=0)

	doGet ( $key, $flags=0, &$casToken=null)

	doGetMulti (array $keys, $flags=0)
	Get an associative array containing the item for each of the keys that have items. More...

	doSet ( $key, $value, $exptime=0, $flags=0)
	Set an item. More...

	doSetMulti (array $data, $exptime=0, $flags=0)

	getExpirationAsTimestamp ( $exptime)
	Convert an optionally relative timestamp to an absolute time. More...

	getExpirationAsTTL ( $exptime)
	Convert an optionally absolute expiry time to a relative time. More...

	getSerialized ( $value, $key)
	Get the serialized form a value, using any applicable prepared value. More...

	guessSerialValueSize ( $value, $depth=0, &$loops=0)
	Estimate the size of a variable once serialized. More...

	isInteger ( $value)
	Check if a value is an integer. More...

	isRelativeExpiration ( $exptime)

	makeValueOrSegmentList ( $key, $value, $exptime, $flags)
	Determine the entry (inline or segment list) to store under a key to save the value. More...

	mergeViaCas ( $key, callable $callback, $exptime, $attempts, $flags)

	resolveSegments ( $key, $mainValue)
	Get and reassemble the chunks of blob at the given key. More...

	serialize ( $value)

	setLastError ( $err)
	Set the "last error" registry. More...

	unserialize ( $value)

Protected Member Functions inherited from BagOStuff
	fieldHasFlags ( $field, $flags)

	mergeFlagMaps (array $bags)
	Merge the flag maps of one or more BagOStuff objects into a "lowest common denominator" map. More...

Additional Inherited Members
Public Attributes inherited from BagOStuff
const	READ_LATEST = 1
	Bitfield constants for get()/getMulti(); these are only advisory. More...

const	READ_VERIFIED = 2

const	WRITE_ALLOW_SEGMENTS = 16

const	WRITE_BACKGROUND = 64

const	WRITE_CACHE_ONLY = 8

const	WRITE_PRUNE_SEGMENTS = 32

const	WRITE_SYNC = 4
	Bitfield constants for set()/merge(); these are only advisory. More...

Protected Attributes inherited from MediumSpecificBagOStuff
callable[]	$busyCallbacks = []

string	$keyspace = 'local'

int	$lastError = self::ERR_NONE
	ERR_* class constant. More...

array[]	$locks = []
	Lock tracking. More...

array[]	$preparedValues = []
	Map of (key => (PHP variable value, serialized value)) More...

int	$segmentationSize
	Bytes; chunk size of segmented cache values. More...

int	$segmentedValueMaxSize
	Bytes; maximum total size of a segmented cache value. More...

int	$syncTimeout
	Seconds. More...

Protected Attributes inherited from BagOStuff
callable null	$asyncHandler

int[]	$attrMap = []
	Map of (ATTR_* class constant => QOS_* class constant) More...

bool	$debugMode = false

LoggerInterface	$logger

Detailed Description

Base class for memcached clients.

Definition at line 29 of file MemcachedBagOStuff.php.

Constructor & Destructor Documentation

◆ __construct()

MemcachedBagOStuff::__construct ( array $params )

See also

BagOStuff::__construct() Additional $params options include:

logger: Psr\Log\LoggerInterface instance
keyspace: Default keyspace for $this->makeKey()
reportDupes: Whether to emit warning log messages for all keys that were requested more than once (requires an asyncHandler).
syncTimeout: How long to wait with WRITE_SYNC in seconds.
segmentationSize: The chunk size, in bytes, of segmented values. The value should not exceed the maximum size of values in the storage backend, as configured by the site administrator.
segmentedValueMaxSize: The maximum total size, in bytes, of segmented values. This should be configured to a reasonable size give the site traffic and the amount of I/O between application and cache servers that the network can handle.

Parameters

array $params -param array{logger?:Psr\Log\LoggerInterface,asyncHandler?:callable,keyspace?:string,reportDupes?:bool,syncTimeout?:int,segmentationSize?:int,segmentedValueMaxSize?:int} $params

Reimplemented from MediumSpecificBagOStuff.

Definition at line 30 of file MemcachedBagOStuff.php.

Member Function Documentation

◆ fixExpiry()

MemcachedBagOStuff::fixExpiry ( $exptime )

protected

Parameters

int | float $exptime

Returns: int

Definition at line 98 of file MemcachedBagOStuff.php.

References BagOStuff\getCurrentTime(), and MediumSpecificBagOStuff\isRelativeExpiration().

Referenced by MemcachedPhpBagOStuff\doAdd(), MemcachedPeclBagOStuff\doAdd(), MemcachedPhpBagOStuff\doCas(), MemcachedPeclBagOStuff\doCas(), MemcachedPhpBagOStuff\doChangeTTL(), MemcachedPeclBagOStuff\doChangeTTL(), MemcachedPhpBagOStuff\doSet(), MemcachedPeclBagOStuff\doSet(), and MemcachedPeclBagOStuff\doSetMulti().

◆ makeKeyInternal()

MemcachedBagOStuff::makeKeyInternal	(	$keyspace,
		$args
	)

Construct a cache key.

Since: 1.27

Parameters

string	$keyspace
array	$args

Returns: string

Reimplemented from MediumSpecificBagOStuff.

Definition at line 45 of file MemcachedBagOStuff.php.

References $args, and MediumSpecificBagOStuff\$keyspace.

◆ validateKeyEncoding()

MemcachedBagOStuff::validateKeyEncoding ( $key )

Ensure that a key is safe to use (contains no control characters and no characters above the ASCII range.)

Parameters

string $key

Returns: string

Exceptions

Exception

Definition at line 87 of file MemcachedBagOStuff.php.

Referenced by MemcachedPhpBagOStuff\decr(), MemcachedPhpBagOStuff\doAdd(), MemcachedPeclBagOStuff\doAdd(), MemcachedPhpBagOStuff\doCas(), MemcachedPeclBagOStuff\doCas(), MemcachedPhpBagOStuff\doChangeTTL(), MemcachedPhpBagOStuff\doDelete(), MemcachedPeclBagOStuff\doDelete(), MemcachedPeclBagOStuff\doDeleteMulti(), MemcachedPhpBagOStuff\doGet(), MemcachedPeclBagOStuff\doGet(), MemcachedPhpBagOStuff\doGetMulti(), MemcachedPeclBagOStuff\doGetMulti(), MemcachedPhpBagOStuff\doSet(), MemcachedPeclBagOStuff\doSet(), MemcachedPeclBagOStuff\doSetMulti(), and MemcachedPhpBagOStuff\incr().

The documentation for this class was generated from the following file:

includes/libs/objectcache/MemcachedBagOStuff.php

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ fixExpiry()

◆ makeKeyInternal()

◆ validateKeyEncoding()