PHP Class Horde_Lock, horde

Author: Ben Klang ([email protected])

Afficher le fichier Open project: horde/horde Class Usage Examples

Protected Properties

Свойство	Type	Description
$_logger	Horde_Log_Logger	Logger.
$_params	array	Driver parameters.

Méthodes publiques

Méthode	Description
__construct ( array $params = [] )	Constructor.
clearLock ( string $lockid ) : boolean	Removes a lock given the lock ID.
getLockInfo ( string $lockid ) : array	Return an array of information about the requested lock.
getLocks ( string $scope = null, string $principal = null, integer $type = null ) : array	Return a list of valid locks with the option to limit the results by principal, scope and/or type.
resetLock ( string $lockid, integer $extend ) : boolean	Extend the valid lifetime of a valid lock to now + $extend.
setLock ( string $requestor, string $scope, string $principal, integer $lifetime = 1, $exclusive = Horde_Lock::TYPE_SHARED ) : mixed	Sets a lock on the requested principal and returns the generated lock ID. NOTE: No security checks are done in the Horde_Lock API. It is expected that the calling application has done all necessary security checks before requesting a lock be granted.

Method Details

__construct() public méthode

Constructor.

public __construct ( array $params = [] )
$params	array	Configuration parameters: 'logger' - (Horde_Log_Logger) A logger instance.

clearLock() abstract public méthode

NOTE: No security checks are done in the Horde_Lock API. It is expected that the calling application has done all necessary security checks before requesting a lock be cleared.

abstract public clearLock ( string $lockid ) : boolean
$lockid	string	The lock ID as generated by a previous call to setLock()
Résultat	boolean	Returns true on success.

getLockInfo() abstract public méthode

Return an array of information about the requested lock.

abstract public getLockInfo ( string $lockid ) : array
$lockid	string	Lock ID to look up.
Résultat	array	Lock information.

getLocks() abstract public méthode

Return a list of valid locks with the option to limit the results by principal, scope and/or type.

abstract public getLocks ( string $scope = null, string $principal = null, integer $type = null ) : array
$scope	string	The scope of the lock. Typically the name of the application requesting the lock or some other identifier used to group locks together.
$principal	string	Principal for which to check for locks
$type	integer	Only return locks of the given type. Defaults to null, or all locks
Résultat	array	Array of locks with the ID as the key and the lock details as the value. If there are no current locks this will return an empty array.

resetLock() abstract public méthode

Extend the valid lifetime of a valid lock to now + $extend.

abstract public resetLock ( string $lockid, integer $extend ) : boolean
$lockid	string	Lock ID to reset. Must be a valid, non-expired lock.
$extend	integer	Extend lock this many seconds from now.
Résultat	boolean	Returns true on success.

setLock() abstract public méthode

Sets a lock on the requested principal and returns the generated lock ID. NOTE: No security checks are done in the Horde_Lock API. It is expected that the calling application has done all necessary security checks before requesting a lock be granted.

abstract public setLock ( string $requestor, string $scope, string $principal, integer $lifetime = 1, $exclusive = Horde_Lock::TYPE_SHARED ) : mixed
$requestor	string	User ID of the lock requestor.
$scope	string	The scope of the lock. Typically the name of the application requesting the lock or some other identifier used to group locks together.
$principal	string	A principal on which a lock should be granted. The format can be any string but is suggested to be in URI form.
$lifetime	integer	Time (in seconds) for which the lock will be considered valid.
Résultat	mixed	A string lock ID.

Property Details

$_logger protected_oe property

Logger.

protected Horde_Log_Logger $_logger
Résultat	Horde_Log_Logger

$_params protected_oe property

Driver parameters.

protected array $_params
Résultat	array