mirror of
https://github.com/predis/predis.git
synced 2026-08-20 08:21:50 +00:00
Daniele Alessandri
184d583895
When using replication backends, now the role of a connection is not defined by its alias but by the new connection parameter "role" that can be set to "master", "slave" and (for redis-sentinel) "sentinel". This also led to a redesign of how connections can be retrieved from replication backends: the method getConnectionById() now retrieves a connection only by its ID (ip:port pair), to get a connection by its alias there is the new method getConnectionByAlias(). This method is not supported by the redis-sentinel backend due to its dynamic nature (connections are retrieved and initialized at runtime from sentinels) but it is still possible to get a single connection from the pool by using its ID. It is also possible to retrive a connection by its role using the method getConnectionByRole(). NOTE: the "role" parameter is an hint for the internals of aggregate connection backends so it is still possible that the actual role of a connection changes during the execution of a script (e.g. a slave gets promoted to the role of master): in this case the parameters of that connection will not be changed as they are immutable, but the method getConnectionByRole() will return the appropriate connection. Predis\Client::getClientBy() has been updated with the addition of "role" and "alias" as supported selectors.
83 lines
2.4 KiB
PHP
83 lines
2.4 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of the Predis package.
|
|
*
|
|
* (c) Daniele Alessandri <suppakilla@gmail.com>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
require __DIR__.'/shared.php';
|
|
|
|
// Predis allows to set Lua scripts as read-only operations for replication.
|
|
// This works for both EVAL and EVALSHA and also for the client-side abstraction
|
|
// built upon them (Predis\Command\ScriptCommand). This example shows a slightly
|
|
// more complex configuration that injects a new script command in the command
|
|
// factory used by the client and marks it as a read-only operation so that it
|
|
// will be executed on slaves.
|
|
|
|
use Predis\Command\ScriptCommand;
|
|
use Predis\Connection\Replication\MasterSlaveReplication;
|
|
use Predis\Replication\ReplicationStrategy;
|
|
|
|
// ------------------------------------------------------------------------- //
|
|
|
|
// Define a new script command that returns all the fields of a variable number
|
|
// of hashes with a single roundtrip.
|
|
|
|
class HashMultipleGetAll extends ScriptCommand
|
|
{
|
|
const BODY = <<<LUA
|
|
local hashes = {}
|
|
for _, key in pairs(KEYS) do
|
|
table.insert(hashes, key)
|
|
table.insert(hashes, redis.call('hgetall', key))
|
|
end
|
|
return hashes
|
|
LUA;
|
|
|
|
public function getScript()
|
|
{
|
|
return self::BODY;
|
|
}
|
|
}
|
|
|
|
// ------------------------------------------------------------------------- //
|
|
|
|
$parameters = array(
|
|
'tcp://127.0.0.1:6381?role=master&database=15',
|
|
'tcp://127.0.0.1:6382?role=slave&alias=slave-01&database=15',
|
|
);
|
|
|
|
$options = array(
|
|
'commands' => array(
|
|
'hmgetall' => 'HashMultipleGetAll',
|
|
),
|
|
'replication' => function () {
|
|
$strategy = new ReplicationStrategy();
|
|
$strategy->setScriptReadOnly(HashMultipleGetAll::BODY);
|
|
|
|
$replication = new MasterSlaveReplication($strategy);
|
|
|
|
return $replication;
|
|
},
|
|
);
|
|
|
|
// ------------------------------------------------------------------------- //
|
|
|
|
$client = new Predis\Client($parameters, $options);
|
|
|
|
// Execute the following commands on the master server using redis-cli:
|
|
// $ ./redis-cli HMSET metavars foo bar hoge piyo
|
|
// $ ./redis-cli HMSET servers master host1 slave host2
|
|
|
|
$hashes = $client->hmgetall('metavars', 'servers');
|
|
|
|
$replication = $client->getConnection();
|
|
$stillOnSlave = $replication->getCurrent() === $replication->getConnectionByAlias('slave-01');
|
|
|
|
echo 'Is still on slave? ', $stillOnSlave ? 'YES!' : 'NO!', PHP_EOL;
|
|
var_export($hashes);
|