2018-06-28 16:57:17 -04:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace Friendica\Core\Lock;
|
|
|
|
|
2020-01-18 09:41:19 -05:00
|
|
|
use Friendica\Core\Cache\Type;
|
2019-08-13 15:20:41 -04:00
|
|
|
|
2018-06-28 16:57:17 -04:00
|
|
|
/**
|
2019-08-04 04:26:53 -04:00
|
|
|
* Class AbstractLock
|
2018-06-28 16:57:17 -04:00
|
|
|
*
|
|
|
|
* @package Friendica\Core\Lock
|
|
|
|
*
|
2018-07-05 01:59:56 -04:00
|
|
|
* Basic class for Locking with common functions (local acquired locks, releaseAll, ..)
|
2018-06-28 16:57:17 -04:00
|
|
|
*/
|
2019-08-04 09:51:49 -04:00
|
|
|
abstract class Lock implements ILock
|
2018-06-28 16:57:17 -04:00
|
|
|
{
|
2020-01-18 09:41:19 -05:00
|
|
|
const TYPE_DATABASE = Type::DATABASE;
|
2019-08-13 15:20:41 -04:00
|
|
|
const TYPE_SEMAPHORE = 'semaphore';
|
|
|
|
|
2018-06-28 16:57:17 -04:00
|
|
|
/**
|
|
|
|
* @var array The local acquired locks
|
|
|
|
*/
|
|
|
|
protected $acquiredLocks = [];
|
|
|
|
|
|
|
|
/**
|
2018-07-05 01:59:56 -04:00
|
|
|
* Check if we've locally acquired a lock
|
2018-06-28 16:57:17 -04:00
|
|
|
*
|
|
|
|
* @param string key The Name of the lock
|
2019-08-03 14:48:56 -04:00
|
|
|
*
|
2018-06-28 16:57:17 -04:00
|
|
|
* @return bool Returns true if the lock is set
|
|
|
|
*/
|
2019-03-04 15:28:36 -05:00
|
|
|
protected function hasAcquiredLock($key)
|
|
|
|
{
|
2018-07-04 17:37:22 -04:00
|
|
|
return isset($this->acquireLock[$key]) && $this->acquiredLocks[$key] === true;
|
2018-06-28 16:57:17 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2018-07-05 01:59:56 -04:00
|
|
|
* Mark a locally acquired lock
|
2018-06-28 16:57:17 -04:00
|
|
|
*
|
|
|
|
* @param string $key The Name of the lock
|
|
|
|
*/
|
2019-03-04 15:28:36 -05:00
|
|
|
protected function markAcquire($key)
|
|
|
|
{
|
2018-06-28 16:57:17 -04:00
|
|
|
$this->acquiredLocks[$key] = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2018-07-05 01:59:56 -04:00
|
|
|
* Mark a release of a locally acquired lock
|
2018-06-28 16:57:17 -04:00
|
|
|
*
|
|
|
|
* @param string $key The Name of the lock
|
|
|
|
*/
|
2019-03-04 15:28:36 -05:00
|
|
|
protected function markRelease($key)
|
|
|
|
{
|
2018-06-28 16:57:17 -04:00
|
|
|
unset($this->acquiredLocks[$key]);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2019-08-13 15:20:41 -04:00
|
|
|
* {@inheritDoc}
|
2018-06-28 16:57:17 -04:00
|
|
|
*/
|
2019-08-13 15:20:41 -04:00
|
|
|
public function releaseAll($override = false)
|
2019-03-04 15:28:36 -05:00
|
|
|
{
|
|
|
|
$return = true;
|
|
|
|
|
2018-07-04 17:37:22 -04:00
|
|
|
foreach ($this->acquiredLocks as $acquiredLock => $hasLock) {
|
2020-01-06 18:24:10 -05:00
|
|
|
if (!$this->release($acquiredLock, $override)) {
|
2019-03-04 15:28:36 -05:00
|
|
|
$return = false;
|
|
|
|
}
|
2018-06-28 16:57:17 -04:00
|
|
|
}
|
2019-03-04 15:28:36 -05:00
|
|
|
|
|
|
|
return $return;
|
2018-06-28 16:57:17 -04:00
|
|
|
}
|
|
|
|
}
|