• Главная
• Predis
• Connection
• Aggregate
• RedisCluster

PHP Класс Predis\Connection\Aggregate\RedisCluster

This connection backend offers smart support for redis-cluster by handling automatic slots map (re)generation upon -MOVED or -ASK responses returned by Redis when redirecting a client to a different node. The cluster can be pre-initialized using only a subset of the actual nodes in the cluster, Predis will do the rest by adjusting the slots map and creating the missing underlying connection instances on the fly. It is possible to pre-associate connections to a slots range with the "slots" parameter in the form "$first-$last". This can greatly reduce runtime node guessing and redirections. It is also possible to ask for the full and updated slots map directly to one of the nodes and optionally enable such a behaviour upon -MOVED redirections. Asking for the cluster configuration to Redis is actually done by issuing a CLUSTER SLOTS command to a random node in the pool. Показать файл Открыть проект Примеры использования класса

Открытые методы

Метод	Описание
__construct ( Predis\Connection\FactoryInterface $connections, Predis\Cluster\StrategyInterface $strategy = null )
add ( Predis\Connection\NodeConnectionInterface $connection )
askSlotsMap ( Predis\Connection\NodeConnectionInterface $connection = null ) : array	Generates an updated slots map fetching the cluster configuration using the CLUSTER SLOTS command against the specified node or a random one from the pool.
buildSlotsMap ( ) : array	Generates the current slots map by guessing the cluster configuration out of the connection parameters of the connections in the pool.
connect ( )
count ( )
disconnect ( )
executeCommand ( Predis\Command\CommandInterface $command )
getClusterStrategy ( ) : Predis\Cluster\StrategyInterface	Returns the underlying command hash strategy used to hash commands by using keys found in their arguments.
getConnection ( Predis\Command\CommandInterface $command )
getConnectionById ( $connectionID )
getConnectionBySlot ( integer $slot ) : Predis\Connection\NodeConnectionInterface	Returns the connection currently associated to a given slot.
getConnectionFactory ( ) : Predis\Connection\FactoryInterface	Returns the underlying connection factory used to create new connection instances to Redis nodes indicated by redis-cluster.
getIterator ( )
getSlotsMap ( ) : array	Returns the current slots map for the cluster.
isConnected ( )
readResponse ( Predis\Command\CommandInterface $command )
remove ( Predis\Connection\NodeConnectionInterface $connection )
removeById ( string $connectionID ) : boolean	Removes a connection instance by using its identifier.
resetSlotsMap ( )	Resets the slots map cache.
setRetryLimit ( integer $retry )	Sets the maximum number of retries for commands upon server failure.
setSlots ( integer $first, integer $last, Predis\Connection\NodeConnectionInterface | string $connection )	Pre-associates a connection to a slots range to avoid runtime guessing.
useClusterSlots ( boolean $value )	Enables automatic fetching of the current slots map from one of the nodes using the CLUSTER SLOTS command. This option is enabled by default as asking the current slots map to Redis upon -MOVED responses may reduce overhead by eliminating the trial-and-error nature of the node guessing procedure, mostly when targeting many keys that would end up in a lot of redirections.
writeRequest ( Predis\Command\CommandInterface $command )

Защищенные методы

Метод	Описание
createConnection ( string $connectionID ) : Predis\Connection\NodeConnectionInterface	Creates a new connection instance from the given connection ID.
getRandomConnection ( ) : Predis\Connection\NodeConnectionInterface | null	Returns a random connection from the pool.
guessNode ( integer $slot ) : string	Guesses the correct node associated to a given slot using a precalculated slots map, falling back to the same logic used by Redis to initialize a cluster (best-effort).
move ( Predis\Connection\NodeConnectionInterface $connection, integer $slot )	Permanently associates the connection instance to a new slot.
onAskResponse ( Predis\Command\CommandInterface $command, string $details ) : mixed	Handles -ASK responses by executing again the command against the node indicated by the Redis response.
onErrorResponse ( Predis\Command\CommandInterface $command, ErrorResponseInterface $error ) : mixed	Handles -ERR responses returned by Redis.
onMovedResponse ( Predis\Command\CommandInterface $command, string $details ) : mixed	Handles -MOVED responses by executing again the command against the node indicated by the Redis response.

Приватные методы

Метод	Описание
queryClusterNodeForSlotsMap ( Predis\Connection\NodeConnectionInterface $connection ) : mixed	Queries the specified node of the cluster to fetch the updated slots map.
retryCommandOnFailure ( Predis\Command\CommandInterface $command, string $method ) : mixed	Ensures that a command is executed one more time on connection failure.

Описание методов