connection = $connection; $this->table = $table; $this->lottery = $lottery; $this->defaultTimeoutInSeconds = $defaultTimeoutInSeconds; } /** * Attempt to acquire the lock. * * @return bool * * @throws \Throwable */ public function acquire() { try { $this->connection->table($this->table)->insert([ 'key' => $this->name, 'owner' => $this->owner, 'expiration' => $this->expiresAt(), ]); $acquired = true; } catch (QueryException) { $updated = $this->connection->table($this->table) ->where('key', $this->name) ->where(function ($query) { return $query->where('owner', $this->owner)->orWhere('expiration', '<=', $this->currentTime()); })->update([ 'owner' => $this->owner, 'expiration' => $this->expiresAt(), ]); $acquired = $updated >= 1; } if (count($this->lottery ?? []) === 2 && random_int(1, $this->lottery[1]) <= $this->lottery[0]) { $this->pruneExpiredLocks(); } return $acquired; } /** * Get the UNIX timestamp indicating when the lock should expire. * * @return int */ protected function expiresAt() { $lockTimeout = $this->seconds > 0 ? $this->seconds : $this->defaultTimeoutInSeconds; return $this->currentTime() + $lockTimeout; } /** * Release the lock. * * @return bool * * @throws \Throwable */ public function release() { try { return $this->connection->table($this->table) ->where('key', $this->name) ->where('owner', $this->owner) ->delete() > 0; } catch (Throwable $e) { if ($this->causedByConcurrencyError($e)) { return true; } throw $e; } } /** * Releases this lock in disregard of ownership. * * @return void */ public function forceRelease() { $this->connection->table($this->table) ->where('key', $this->name) ->delete(); } /** * Deletes locks that are past expiration. * * @return void * * @throws \Throwable */ public function pruneExpiredLocks() { try { $this->connection->table($this->table) ->where('expiration', '<=', $this->currentTime()) ->delete(); } catch (Throwable $e) { if (! $this->causedByConcurrencyError($e)) { throw $e; } } } /** * Returns the owner value written into the driver for this lock. * * @return string|null */ protected function getCurrentOwner() { return $this->connection->table($this->table) ->where('key', $this->name) ->where('expiration', '>', $this->currentTime()) ->first()?->owner; } /** * Get the name of the database connection being used to manage the lock. * * @return string */ public function getConnectionName() { return $this->connection->getName(); } }