2018-06-28 16:57:17 -04:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace Friendica\Core\Lock;
|
2018-07-04 17:37:22 -04:00
|
|
|
use Friendica\BaseObject;
|
2018-06-28 16:57:17 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Class AbstractLockDriver
|
|
|
|
*
|
|
|
|
* @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
|
|
|
*/
|
2018-07-04 17:37:22 -04:00
|
|
|
abstract class AbstractLockDriver extends BaseObject implements ILockDriver
|
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
|
|
|
|
* @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]);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2018-07-05 01:59:56 -04:00
|
|
|
* Releases all lock that were set by us
|
2018-06-28 16:57:17 -04:00
|
|
|
*
|
2019-03-04 15:28:36 -05:00
|
|
|
* @return boolean Was the unlock of all locks successful?
|
2018-06-28 16:57:17 -04:00
|
|
|
*/
|
2019-03-04 15:28:36 -05:00
|
|
|
public function releaseAll()
|
|
|
|
{
|
|
|
|
$return = true;
|
|
|
|
|
2018-07-04 17:37:22 -04:00
|
|
|
foreach ($this->acquiredLocks as $acquiredLock => $hasLock) {
|
2019-03-04 15:28:36 -05:00
|
|
|
if (!$this->releaseLock($acquiredLock)) {
|
|
|
|
$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
|
|
|
}
|
|
|
|
}
|