KVStore

In-memory key/value store component with optional persistence.

class KVStore

Properties

server

Owning server instance.

private Main $server

log

Logger used for KV operation diagnostics.

private Logger $log

config

Configuration for the KV Store component.

private array $config

kvStore

private array $kvStore

kvExpire

private array $kvExpire

db

public BTree $db

compactTime

Interval (seconds) between persistence compaction runs.

private int $compactTime

lastCompact

Timestamp of the most recent compaction.

private int $lastCompact

Methods

__construct

KVStore constructor.

public __construct(Main $server, array $config): void

Parameters

Parameter	Type	Description
$server	Main	the server instance
$config	array	configuration for the KV Store component

enablePersistentStorage

Enables persistent KV storage and optional auto-compaction.

public enablePersistentStorage(int $compactTime = 3600): bool

Parameters

Parameter	Type	Description
$compactTime	int

disablePersistentStorage

Disables persistent storage and compaction state.

public disablePersistentStorage(): void

expireKeys

Expires keys that reached TTL and compacts persistence if due.

public expireKeys(): void

touch

public touch(string $namespace, string $key): void

Parameters

Parameter	Type	Description
$namespace	string
$key	string

process

Dispatches inbound KV commands to the matching handler.

public process(Client $client, PacketType $command, mixed $payload): void

Parameters

Parameter	Type	Description
$client	Client
$command	PacketType
$payload	mixed

get

Handles KVGET command.

public get(Client $client, mixed $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	mixed
$namespace	string

set

Handles KVSET command.

public set(Client $client, mixed $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	mixed
$namespace	string

has

Handles KVHAS command.

public has(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

del

Handles KVDEL command.

public del(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

Handles KVLIST command.

public (Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

clear

Handles KVCLEAR command.

public clear(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

pull

Handles KVPULL command.

public pull(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

push

Handles KVPUSH command.

public push(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

pop

Handles KVPOP command.

public pop(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

shift

Handles KVSHIFT command.

public shift(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

unshift

Handles KVUNSHIFT command.

public unshift(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

count

Handles KVCOUNT command.

public count(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

incr

Handles KVINCR command.

public incr(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

decr

Handles KVDECR command.

public decr(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

keys

Handles KVKEYS command.

public keys(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

values

Handles KVVALS command.

public values(Client $client, \stdClass $payload, string $namespace): void

Parameters

Parameter	Type	Description
$client	Client
$payload	\stdClass
$namespace	string

---

Generated by Hazaar API Doc Generator on Tue, 21 Apr 2026 04:00:25 +0000