class Sentinel

Relay Sentinel client.

Constants

OPT_THROW_ON_ERR

Whether to throw an exception on -ERR replies. Default: false

OPT_AUTO_DISCOVER

Whether \Relay\Sentinel should automatically discover other sentinels in the cluster, so it may use them if we fail to communicate with the first one.

Methods

__construct(array|string|null $host = null, int $port = 26379, float $timeout = 0, mixed $persistent = null, int $retry_interval = 0, float $read_timeout = 0, mixed $auth = null, array|null $context = null)

Establishes a new connection to a Sentinel instance.

bool
ckquorum(string $master)

Check if the current Sentinel configuration is able to reach the quorum needed to failover a master, and the majority needed to authorize the failover.

bool
failover(string $master)

Force a failover as if the master was not reachable, and without asking for agreement to other Sentinels.

bool
flushconfig()

Force Sentinel to rewrite its configuration on disk, including the current Sentinel state.

array|false
getMasterAddrByName(string $master)

Returns the ip and port number of the master with that name.

array|false
getPrimaryAddrByName(string $master)

Returns the ip and port number of the primary with that name.

array|false
master(string $master)

Returns the state and info of the specified master.

array|false
primary(string $master)

Returns the state and info of the specified primary.

array|false
masters()

Returns a list of monitored masters and their state.

array|false
primaries()

Returns a list of monitored primaries and their state.

string
myid()

Returns the ID of the Sentinel instance.

string|bool
ping(string|null $message = null)

Returns PONG if no message is provided, otherwise returns the message.

int
reset(string $pattern)

Will reset all the masters with matching name.

array|false
sentinels(string $master)

Returns a list of sentinel instances for this master, and their state.

array|false
slaves(string $master)

Show a list of replicas for this master, and their state.

string|null
getLastError()

Returns the last error message, if any.

bool
setOption(int $option, mixed $value)

Sets a client option.

mixed
getOption(int $option)

Returns a client option.

Details

at line 4147
__construct(array|string|null $host = null, int $port = 26379, float $timeout = 0, mixed $persistent = null, int $retry_interval = 0, float $read_timeout = 0, mixed $auth = null, array|null $context = null)

Establishes a new connection to a Sentinel instance.

For backwards compatibility with PhpRedis 6.x, the constructor may be called with a single options array.

Parameters

array|string|null $host
int $port
float $timeout
mixed $persistent
int $retry_interval
float $read_timeout
mixed $auth
array|null $context

at line 4167
bool ckquorum(string $master)

Check if the current Sentinel configuration is able to reach the quorum needed to failover a master, and the majority needed to authorize the failover.

Parameters

string $master

Return Value

bool

at line 4177
bool failover(string $master)

Force a failover as if the master was not reachable, and without asking for agreement to other Sentinels.

Parameters

string $master

Return Value

bool

at line 4186
bool flushconfig()

Force Sentinel to rewrite its configuration on disk, including the current Sentinel state.

Return Value

bool

at line 4195
array|false getMasterAddrByName(string $master)

Returns the ip and port number of the master with that name.

Parameters

string $master

Return Value

array|false

at line 4206
array|false getPrimaryAddrByName(string $master)

Returns the ip and port number of the primary with that name.

Parameters

string $master

Return Value

array|false

at line 4215
array|false master(string $master)

Returns the state and info of the specified master.

Parameters

string $master

Return Value

array|false

at line 4226
array|false primary(string $master)

Returns the state and info of the specified primary.

Parameters

string $master

Return Value

array|false

at line 4234
array|false masters()

Returns a list of monitored masters and their state.

Return Value

array|false

at line 4244
array|false primaries()

Returns a list of monitored primaries and their state.

Return Value

array|false

at line 4252
string myid()

Returns the ID of the Sentinel instance.

Return Value

string

at line 4261
string|bool ping(string|null $message = null)

Returns PONG if no message is provided, otherwise returns the message.

Parameters

string|null $message

Return Value

string|bool

at line 4270
int reset(string $pattern)

Will reset all the masters with matching name.

Parameters

string $pattern

Return Value

int

at line 4279
array|false sentinels(string $master)

Returns a list of sentinel instances for this master, and their state.

Parameters

string $master

Return Value

array|false

at line 4288
array|false slaves(string $master)

Show a list of replicas for this master, and their state.

Parameters

string $master

Return Value

array|false

at line 4296
string|null getLastError()

Returns the last error message, if any.

Return Value

string|null

at line 4306
bool setOption(int $option, mixed $value)

Sets a client option.

Parameters

int $option
mixed $value

Return Value

bool

at line 4315
mixed getOption(int $option)

Returns a client option.

Parameters

int $option

Return Value

mixed