Manage locks using memcached servers. More...

Inheritance diagram for MemcLockManager:

Collaboration diagram for MemcLockManager:

[legend]

Public Member Functions
	__construct (array $config)
	Construct a new instance from configuration. More...

	__destruct ()
	Make sure remaining locks get cleared for sanity. More...

Public Member Functions inherited from LockManager
	lock (array $paths, $type=self::LOCK_EX, $timeout=0)
	Lock the resources at the given abstract paths. More...

	lockByType (array $pathsByType, $timeout=0)
	Lock the resources at the given abstract paths. More...

	unlock (array $paths, $type=self::LOCK_EX)
	Unlock the resources at the given abstract paths. More...

	unlockByType (array $pathsByType)
	Unlock the resources at the given abstract paths. More...

Protected Member Functions
	acquireMutexes (MemcachedBagOStuff $memc, array $keys)

	doFreeLocksOnServer ( $lockSrv, array $paths, $type)

	doGetLocksOnServer ( $lockSrv, array $paths, $type)

	freeLocksOnServer ( $lockSrv, array $pathsByType)
	Get a connection to a lock server and release locks on $paths. More...

	getCache ( $lockSrv)
	Get the MemcachedBagOStuff object for a $lockSrv. More...

	getLocksOnServer ( $lockSrv, array $pathsByType)
	Get a connection to a lock server and acquire locks. More...

	isServerUp ( $lockSrv)

	recordKeyForPath ( $path)

	releaseAllLocks ()

	releaseMutexes (MemcachedBagOStuff $memc, array $keys)

Protected Member Functions inherited from QuorumLockManager
	doLock (array $paths, $type)
	Lock resources with the given keys and lock type. More...

	doLockByType (array $pathsByType)

	doLockingRequestBucket ( $bucket, array $pathsByType)
	Attempt to acquire locks with the peers for a bucket. More...

	doUnlock (array $paths, $type)
	Unlock resources with the given keys and lock type. More...

	doUnlockByType (array $pathsByType)

	doUnlockingRequestBucket ( $bucket, array $pathsByType)
	Attempt to release locks with the peers for a bucket. More...

	getBucketFromPath ( $path)
	Get the bucket for resource path. More...

Protected Member Functions inherited from LockManager
	normalizePathsByType (array $pathsByType)
	Normalize the $paths array by converting LOCK_UW locks into the appropriate type and removing any duplicated paths for each lock type. More...

	sha1Base16Absolute ( $path)
	Get the base 16 SHA-1 of a string, padded to 31 digits. More...

	sha1Base36Absolute ( $path)
	Get the base 36 SHA-1 of a string, padded to 31 digits. More...

Static Protected Member Functions
static	newLockArray ()

static	sanitizeLockArray ( $a)

Protected Attributes
array	$bagOStuffs = array()
	Map server names to MemcachedBagOStuff objects *. More...

array	$lockTypeMap
	Mapping of lock types to the type actually used *. More...

array	$serversUp = array()
	(server name => bool) * More...

string	$session = ''
	random UUID * More...

Protected Attributes inherited from QuorumLockManager
array	$degradedBuckets = array()
	Map of degraded buckets *. More...

array	$srvsByBucket = array()
	Map of bucket indexes to peer server lists *. More...

Protected Attributes inherited from LockManager
	$domain

array	$locksHeld = array()
	Map of (resource path => lock type => count) *. More...

	$lockTTL

array	$lockTypeMap
	Mapping of lock types to the type actually used *. More...

Additional Inherited Members
Public Attributes inherited from LockManager
const	LOCK_EX = 3

const	LOCK_SH = 1
	Lock types; stronger locks have higher values. More...

const	LOCK_UW = 2

Detailed Description

Manage locks using memcached servers.

Version of LockManager based on using memcached servers. This is meant for multi-wiki systems that may share files. All locks are non-blocking, which avoids deadlocks.

All lock requests for a resource, identified by a hash string, will map to one bucket. Each bucket maps to one or several peer servers, each running memcached. A majority of peers must agree for a lock to be acquired.

Since: 1.20

Definition at line 38 of file MemcLockManager.php.

Constructor & Destructor Documentation

◆ __construct()

MemcLockManager::__construct ( array $config )

Construct a new instance from configuration.

Parameters

array

$config

Paramaters include:

lockServers : Associative array of server names to "<IP>:<port>" strings.
srvsByBucket : Array of 1-16 consecutive integer keys, starting from 0, each having an odd-numbered list of server names (peers) as values.
memcConfig : Configuration array for ObjectCache::newFromParams. [optional] If set, this must use one of the memcached classes.

Exceptions

MWException

Reimplemented from LockManager.

Definition at line 62 of file MemcLockManager.php.

References $cache, $name, $params, array(), as, ObjectCache\newFromParams(), and wfRandomString().

◆ __destruct()

MemcLockManager::__destruct ( )

Make sure remaining locks get cleared for sanity.

Definition at line 372 of file MemcLockManager.php.

References $path, array(), as, and QuorumLockManager\doUnlock().

Member Function Documentation

◆ acquireMutexes()

MemcLockManager::acquireMutexes	(	MemcachedBagOStuff	$memc,
		array	$keys
	)

protected

Parameters

MemcachedBagOStuff	$memc
array	$keys	List of keys to acquire

Returns: bool

Definition at line 326 of file MemcLockManager.php.

References $keys, MemcachedBagOStuff\add(), array(), as, and releaseMutexes().

Referenced by doFreeLocksOnServer(), and doGetLocksOnServer().

◆ doFreeLocksOnServer()

MemcLockManager::doFreeLocksOnServer	(		$lockSrv,
		array	$paths,
			$type
	)

protected

See also: QuorumLockManager::freeLocksOnServer()

Parameters

string	$lockSrv
array	$paths
string	$type

Returns: Status

Definition at line 203 of file MemcLockManager.php.

References $keys, LockManager\$locksHeld, $ok, $path, $type, acquireMutexes(), array(), as, getCache(), Status\newGood(), recordKeyForPath(), releaseMutexes(), sanitizeLockArray(), and wfDebug().

Referenced by freeLocksOnServer(), and getLocksOnServer().

◆ doGetLocksOnServer()

MemcLockManager::doGetLocksOnServer	(		$lockSrv,
		array	$paths,
			$type
	)

protected

See also: QuorumLockManager::getLocksOnServer()

Parameters

string	$lockSrv
array	$paths
string	$type

Returns: Status

Definition at line 127 of file MemcLockManager.php.

References $keys, LockManager\$locksHeld, LockManager\$lockTTL, $ok, $path, $session, $type, acquireMutexes(), array(), as, getCache(), Status\newGood(), newLockArray(), recordKeyForPath(), releaseMutexes(), sanitizeLockArray(), and wfDebug().

Referenced by getLocksOnServer().

◆ freeLocksOnServer()

MemcLockManager::freeLocksOnServer	(		$lockSrv,
		array	$pathsByType
	)

protected

Get a connection to a lock server and release locks on $paths.

Subclasses must effectively implement this or releaseAllLocks().

Parameters

string	$lockSrv
array	$pathsByType	Map of LockManager::LOCK_* constants to lists of paths

Returns: Status

Reimplemented from QuorumLockManager.

Definition at line 110 of file MemcLockManager.php.

References $type, as, doFreeLocksOnServer(), and Status\newGood().

◆ getCache()

MemcLockManager::getCache ( $lockSrv )

protected

Get the MemcachedBagOStuff object for a $lockSrv.

Parameters

string $lockSrv Server name

Returns: MemcachedBagOStuff|null

Definition at line 274 of file MemcLockManager.php.

Referenced by doFreeLocksOnServer(), doGetLocksOnServer(), and isServerUp().

◆ getLocksOnServer()

MemcLockManager::getLocksOnServer	(		$lockSrv,
		array	$pathsByType
	)

protected

Get a connection to a lock server and acquire locks.

Parameters

string	$lockSrv
array	$pathsByType	Map of LockManager::LOCK_* constants to lists of paths

Returns: Status

Reimplemented from QuorumLockManager.

Definition at line 88 of file MemcLockManager.php.

References $type, array(), as, doFreeLocksOnServer(), doGetLocksOnServer(), and Status\newGood().

◆ isServerUp()

MemcLockManager::isServerUp ( $lockSrv )

protected

See also: QuorumLockManager::isServerUp()

Parameters

string $lockSrv

Returns: bool

Reimplemented from QuorumLockManager.

Definition at line 264 of file MemcLockManager.php.

References getCache().

◆ newLockArray()

static MemcLockManager::newLockArray ( )

staticprotected

Returns: array An empty lock structure for a key

Definition at line 303 of file MemcLockManager.php.

References array().

Referenced by doGetLocksOnServer(), and sanitizeLockArray().

◆ recordKeyForPath()

MemcLockManager::recordKeyForPath ( $path )

protected

Parameters

string $path

Returns: string

Definition at line 296 of file MemcLockManager.php.

References $path, array(), and LockManager\sha1Base36Absolute().

Referenced by doFreeLocksOnServer(), and doGetLocksOnServer().

◆ releaseAllLocks()

MemcLockManager::releaseAllLocks ( )

protected

See also: QuorumLockManager::releaseAllLocks()

Returns: Status

Reimplemented from QuorumLockManager.

Definition at line 255 of file MemcLockManager.php.

References Status\newGood().

◆ releaseMutexes()

MemcLockManager::releaseMutexes	(	MemcachedBagOStuff	$memc,
		array	$keys
	)

protected

Parameters

MemcachedBagOStuff	$memc
array	$keys	List of acquired keys

Definition at line 363 of file MemcLockManager.php.

References $keys, as, and MemcachedBagOStuff\delete().

Referenced by acquireMutexes(), doFreeLocksOnServer(), and doGetLocksOnServer().

◆ sanitizeLockArray()

static MemcLockManager::sanitizeLockArray ( $a )

staticprotected

Parameters

array $a

Returns: array An empty lock structure for a key

Definition at line 311 of file MemcLockManager.php.

References newLockArray().

Referenced by doFreeLocksOnServer(), and doGetLocksOnServer().

Member Data Documentation

◆ $bagOStuffs

array MemcLockManager::$bagOStuffs = array()

protected

Map server names to MemcachedBagOStuff objects *.

Definition at line 45 of file MemcLockManager.php.

◆ $lockTypeMap

array MemcLockManager::$lockTypeMap

protected

Initial value:

= array(
        self::LOCK_SH => self::LOCK_SH,
        self::LOCK_UW => self::LOCK_SH,
        self::LOCK_EX => self::LOCK_EX
    )

Mapping of lock types to the type actually used *.

Definition at line 39 of file MemcLockManager.php.

◆ $serversUp

array MemcLockManager::$serversUp = array()

protected

(server name => bool) *

Definition at line 47 of file MemcLockManager.php.

◆ $session

string MemcLockManager::$session = ''

protected

random UUID *

Definition at line 49 of file MemcLockManager.php.

Referenced by doGetLocksOnServer().

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

includes/filebackend/lockmanager/MemcLockManager.php

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

◆ __destruct()

Member Function Documentation

◆ acquireMutexes()

◆ doFreeLocksOnServer()

◆ doGetLocksOnServer()

◆ freeLocksOnServer()

◆ getCache()

◆ getLocksOnServer()

◆ isServerUp()

◆ newLockArray()

◆ recordKeyForPath()

◆ releaseAllLocks()

◆ releaseMutexes()

◆ sanitizeLockArray()

Member Data Documentation

◆ $bagOStuffs

◆ $lockTypeMap

◆ $serversUp

◆ $session