2018-06-28 22:57:17 +02:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace Friendica\Core\Lock;
|
|
|
|
|
|
|
|
/**
|
2019-08-04 10:26:53 +02:00
|
|
|
* Class AbstractLock
|
2018-06-28 22:57:17 +02:00
|
|
|
*
|
|
|
|
* @package Friendica\Core\Lock
|
|
|
|
*
|
2018-07-05 07:59:56 +02:00
|
|
|
* Basic class for Locking with common functions (local acquired locks, releaseAll, ..)
|
2018-06-28 22:57:17 +02:00
|
|
|
*/
|
2019-08-04 15:51:49 +02:00
|
|
|
abstract class Lock implements ILock
|
2018-06-28 22:57:17 +02:00
|
|
|
{
|
|
|
|
/**
|
|
|
|
* @var array The local acquired locks
|
|
|
|
*/
|
|
|
|
protected $acquiredLocks = [];
|
|
|
|
|
|
|
|
/**
|
2018-07-05 07:59:56 +02:00
|
|
|
* Check if we've locally acquired a lock
|
2018-06-28 22:57:17 +02:00
|
|
|
*
|
|
|
|
* @param string key The Name of the lock
|
2019-08-03 20:48:56 +02:00
|
|
|
*
|
2018-06-28 22:57:17 +02:00
|
|
|
* @return bool Returns true if the lock is set
|
|
|
|
*/
|
2019-03-04 21:28:36 +01:00
|
|
|
protected function hasAcquiredLock($key)
|
|
|
|
{
|
2018-07-04 23:37:22 +02:00
|
|
|
return isset($this->acquireLock[$key]) && $this->acquiredLocks[$key] === true;
|
2018-06-28 22:57:17 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2018-07-05 07:59:56 +02:00
|
|
|
* Mark a locally acquired lock
|
2018-06-28 22:57:17 +02:00
|
|
|
*
|
|
|
|
* @param string $key The Name of the lock
|
|
|
|
*/
|
2019-03-04 21:28:36 +01:00
|
|
|
protected function markAcquire($key)
|
|
|
|
{
|
2018-06-28 22:57:17 +02:00
|
|
|
$this->acquiredLocks[$key] = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2018-07-05 07:59:56 +02:00
|
|
|
* Mark a release of a locally acquired lock
|
2018-06-28 22:57:17 +02:00
|
|
|
*
|
|
|
|
* @param string $key The Name of the lock
|
|
|
|
*/
|
2019-03-04 21:28:36 +01:00
|
|
|
protected function markRelease($key)
|
|
|
|
{
|
2018-06-28 22:57:17 +02:00
|
|
|
unset($this->acquiredLocks[$key]);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2018-07-05 07:59:56 +02:00
|
|
|
* Releases all lock that were set by us
|
2018-06-28 22:57:17 +02:00
|
|
|
*
|
2019-03-04 21:28:36 +01:00
|
|
|
* @return boolean Was the unlock of all locks successful?
|
2018-06-28 22:57:17 +02:00
|
|
|
*/
|
2019-03-04 21:28:36 +01:00
|
|
|
public function releaseAll()
|
|
|
|
{
|
|
|
|
$return = true;
|
|
|
|
|
2018-07-04 23:37:22 +02:00
|
|
|
foreach ($this->acquiredLocks as $acquiredLock => $hasLock) {
|
2019-03-04 21:28:36 +01:00
|
|
|
if (!$this->releaseLock($acquiredLock)) {
|
|
|
|
$return = false;
|
|
|
|
}
|
2018-06-28 22:57:17 +02:00
|
|
|
}
|
2019-03-04 21:28:36 +01:00
|
|
|
|
|
|
|
return $return;
|
2018-06-28 22:57:17 +02:00
|
|
|
}
|
|
|
|
}
|