1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
<?php
declare(strict_types=1);
namespace malkusch\lock\mutex;
use InvalidArgumentException;
use malkusch\lock\exception\LockAcquireException;
use malkusch\lock\exception\LockReleaseException;
/**
* System V IPC based mutex implementation.
*
* @author Markus Malkusch <markus@malkusch.de>
* @link bitcoin:1P5FAZ4QhXCuwYPnLZdk3PJsqePbu1UDDA Donations
* @license WTFPL
*/
class SemaphoreMutex extends LockMutex
{
/**
* @var \SysvSemaphore|resource The semaphore id.
*/
private $semaphore;
/**
* Sets the semaphore id.
*
* Use {@link sem_get()} to create the semaphore id.
*
* Example:
* <code>
* $semaphore = sem_get(ftok(__FILE__, "a"));
* $mutex = new SemaphoreMutex($semaphore);
* </code>
*
* @param \SysvSemaphore|resource $semaphore The semaphore id.
* @throws \InvalidArgumentException The semaphore id is not a valid resource.
*/
public function __construct($semaphore)
{
if (!$semaphore instanceof \SysvSemaphore && !is_resource($semaphore)) {
throw new InvalidArgumentException('The semaphore id is not a valid resource.');
}
$this->semaphore = $semaphore;
}
/**
* @internal
*/
protected function lock(): void
{
if (!sem_acquire($this->semaphore)) {
throw new LockAcquireException('Failed to acquire the Semaphore.');
}
}
/**
* @internal
*/
protected function unlock(): void
{
if (!sem_release($this->semaphore)) {
throw new LockReleaseException('Failed to release the Semaphore.');
}
}
}
|
