Simple version of LockManager based on using FS lock files. More...

Inheritance diagram for FSLockManager:

Collaboration diagram for FSLockManager:

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
	doLock (array $paths, $type)

	doSingleLock ( $path, $type)
	Lock a single resource key. More...

	doSingleUnlock ( $path, $type)
	Unlock a single resource key. More...

	doUnlock (array $paths, $type)

	getLockPath ( $path)
	Get the path to the lock file for a key. More...

Protected Member Functions inherited from LockManager
	doLockByType (array $pathsByType)

	doUnlockByType (array $pathsByType)

	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...

Protected Attributes
array	$handles = array()
	Map of (locked key => lock file handle) *. More...

	$lockDir

array	$lockTypeMap
	Mapping of lock types to the type actually used *. 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...

Private Member Functions
	closeLockHandles ( $path, array $handlesToClose)

	pruneKeyLockFiles ( $path)

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

Simple version of LockManager based on using FS lock files.

All locks are non-blocking, which avoids deadlocks.

This should work fine for small sites running off one server. Do not use this with 'lockDirectory' set to an NFS mount unless the NFS client is at least version 2.6.12. Otherwise, the BSD flock() locks will be ignored; see http://nfs.sourceforge.net/#section_d.

Since: 1.19

Definition at line 36 of file FSLockManager.php.

Constructor & Destructor Documentation

◆ __construct()

FSLockManager::__construct ( array $config )

Construct a new instance from configuration.

Parameters

array

$config

Includes:

lockDirectory : Directory containing the lock files

Reimplemented from LockManager.

Definition at line 53 of file FSLockManager.php.

◆ __destruct()

FSLockManager::__destruct ( )

Make sure remaining locks get cleared for sanity.

Definition at line 238 of file FSLockManager.php.

References $path, as, and doSingleUnlock().

Member Function Documentation

◆ closeLockHandles()

FSLockManager::closeLockHandles	(		$path,
		array	$handlesToClose
	)

private

Parameters

string	$path
array	$handlesToClose

Returns: Status

Definition at line 195 of file FSLockManager.php.

References $path, as, and Status\newGood().

Referenced by doSingleUnlock().

◆ doLock()

FSLockManager::doLock	(	array	$paths,
			$type
	)

protected

See also: LockManager::doLock()

Parameters

array	$paths
int	$type

Returns: Status

Reimplemented from LockManager.

Definition at line 65 of file FSLockManager.php.

References $path, $type, array(), as, doSingleLock(), doUnlock(), and Status\newGood().

◆ doSingleLock()

FSLockManager::doSingleLock	(	$path,
		$type
	)

protected

Lock a single resource key.

Parameters

string	$path
int	$type

Returns: Status

Definition at line 107 of file FSLockManager.php.

References $path, $type, getLockPath(), LockManager\LOCK_EX, LockManager\LOCK_SH, Status\newGood(), wfMkdirParents(), wfRestoreWarnings(), and wfSuppressWarnings().

Referenced by doLock().

◆ doSingleUnlock()

FSLockManager::doSingleUnlock	(	$path,
		$type
	)

protected

Unlock a single resource key.

Parameters

string	$path
int	$type

Returns: Status

Definition at line 152 of file FSLockManager.php.

References $path, $type, array(), closeLockHandles(), Status\newGood(), pruneKeyLockFiles(), and wfIsWindows().

Referenced by __destruct(), and doUnlock().

◆ doUnlock()

FSLockManager::doUnlock	(	array	$paths,
			$type
	)

protected

See also: LockManager::doUnlock()

Parameters

array	$paths
int	$type

Returns: Status

Reimplemented from LockManager.

Definition at line 90 of file FSLockManager.php.

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

Referenced by doLock().

◆ getLockPath()

FSLockManager::getLockPath ( $path )

protected

Get the path to the lock file for a key.

Parameters

string $path

Returns: string

Definition at line 231 of file FSLockManager.php.

Referenced by doSingleLock(), and pruneKeyLockFiles().

◆ pruneKeyLockFiles()

FSLockManager::pruneKeyLockFiles ( $path )

private

Parameters

string $path

Returns: Status

Definition at line 213 of file FSLockManager.php.

References $path, getLockPath(), and Status\newGood().

Referenced by doSingleUnlock().

Member Data Documentation

◆ $handles

array FSLockManager::$handles = array()

protected

Map of (locked key => lock file handle) *.

Definition at line 45 of file FSLockManager.php.

◆ $lockDir

FSLockManager::$lockDir

protected

Definition at line 43 of file FSLockManager.php.

◆ $lockTypeMap

array FSLockManager::$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 37 of file FSLockManager.php.

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

includes/filebackend/lockmanager/FSLockManager.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

◆ __destruct()

Member Function Documentation

◆ closeLockHandles()

◆ doLock()

◆ doSingleLock()

◆ doSingleUnlock()

◆ doUnlock()

◆ getLockPath()

◆ pruneKeyLockFiles()

Member Data Documentation

◆ $handles

◆ $lockDir

◆ $lockTypeMap