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