abstract class Lock implements Lock (View source)

Traits

Properties

protected string $name The name of the lock.
protected int $seconds The number of seconds the lock should be maintained.
protected string $owner The scope identifier of this lock.

Methods

int
secondsUntil(DateTimeInterface|DateInterval|int $delay)

Get the number of seconds until the given DateTime.

int
availableAt(DateTimeInterface|DateInterval|int $delay = 0)

Get the "available at" UNIX timestamp.

parseDateInterval(DateTimeInterface|DateInterval|int $delay)

If the given value is an interval, convert it to a DateTime instance.

int
currentTime()

Get the current system time as a UNIX timestamp.

void
__construct(string $name, int $seconds, string|null $owner = null)

Create a new lock instance.

bool
acquire()

Attempt to acquire the lock.

void
release()

Release the lock.

string
getCurrentOwner()

Returns the owner value written into the driver for this lock.

bool
get(callable|null $callback = null)

Attempt to acquire the lock.

bool
block(int $seconds, callable|null $callback = null)

Attempt to acquire the lock for the given number of seconds.

string
owner()

Returns the current owner of the lock.

bool
isOwnedByCurrentProcess()

Determines whether this lock is allowed to release the lock in the driver.

Details

protected int secondsUntil(DateTimeInterface|DateInterval|int $delay)

Get the number of seconds until the given DateTime.

Parameters

DateTimeInterface|DateInterval|int $delay

Return Value

int

protected int availableAt(DateTimeInterface|DateInterval|int $delay = 0)

Get the "available at" UNIX timestamp.

Parameters

DateTimeInterface|DateInterval|int $delay

Return Value

int

protected DateTimeInterface|int parseDateInterval(DateTimeInterface|DateInterval|int $delay)

If the given value is an interval, convert it to a DateTime instance.

Parameters

DateTimeInterface|DateInterval|int $delay

Return Value

DateTimeInterface|int

protected int currentTime()

Get the current system time as a UNIX timestamp.

Return Value

int

void __construct(string $name, int $seconds, string|null $owner = null)

Create a new lock instance.

Parameters

string $name
int $seconds
string|null $owner

Return Value

void

abstract bool acquire()

Attempt to acquire the lock.

Return Value

bool

abstract void release()

Release the lock.

Return Value

void

abstract protected string getCurrentOwner()

Returns the owner value written into the driver for this lock.

Return Value

string

bool get(callable|null $callback = null)

Attempt to acquire the lock.

Parameters

callable|null $callback

Return Value

bool

bool block(int $seconds, callable|null $callback = null)

Attempt to acquire the lock for the given number of seconds.

Parameters

int $seconds
callable|null $callback

Return Value

bool

Exceptions

LockTimeoutException

string owner()

Returns the current owner of the lock.

Return Value

string

protected bool isOwnedByCurrentProcess()

Determines whether this lock is allowed to release the lock in the driver.

Return Value

bool