概要

クラスタへの接続方法

1. シードノードを直接指定

複数のノードの中から1つ以上を初期接続先として渡す。内部的に CLUSTER SLOTS コマンドを実行し、キー空間全体のマッピングを行う。

// 複数のシードノードを指定
$cluster = new RedisCluster(null, ['192.168.1.10:7000', '192.168.1.11:7001']);

// タイムアウトと読み取りタイムアウトを設定（秒単位）
$cluster = new RedisCluster(null, ['192.168.1.10:7000'], 2.0, 1.5);

// 永続接続を有効化
$cluster = new RedisCluster(null, ['192.168.1.10:7000'], 2.0, 1.5, true);

2. redis.ini 経由での名前付きクラスタ定義

設定ファイル内で事前にクラスタ構成を登録しておくことで、名前だけでインスタンスを生成できる。

; redis.ini
redis.clusters.seeds = "prod[]=10.0.0.1:7000&prod[]=10.0.0.2:7000&dev[]=127.0.0.1:7000"
redis.clusters.timeout = "prod=3"
redis.clusters.read_timeout = "prod=5"

PHP 側では以下のように接続：

// 名前付きクラスタを初期化
$cluster = new RedisCluster('prod');

通信時のタイムアウト処理

キー空間の動的更新

スレーブノードの利用オプション

// デフォルト：すべての読み書きをマスタへ
$cluster->setOption(RedisCluster::OPT_SLAVE_FAILOVER, RedisCluster::FAILOVER_NONE);

// マスタ障害時のみスレーブを利用（読み取り）
$cluster->setOption(RedisCluster::OPT_SLAVE_FAILOVER, RedisCluster::FAILOVER_ERROR);

// 読み取りコマンドをマスタ・スレーブ間でランダム分散（ロードバランシング）
$cluster->setOption(RedisCluster::OPT_SLAVE_FAILOVER, RedisCluster::FAILOVER_DISTRIBUTE);

コマンド実行フロー

1. 対象ノードにコマンドを送信
2. MOVED/ASK 応答があればマッピング更新または再送
3. 有効な応答を得るか、次のいずれかの条件に該当するまで繰り返す：
   • すべての既知ノードに接続不可
   • 指定タイムアウト時間超過
   • CLUSTERDOWN 状態が報告された
4. 最終的に結果または例外を返却

トランザクションの扱い

$cluster->multi();
$cluster->get('user:1000');
$cluster->set('user:1001', 'alice');

// user:2000 が別のノードにある場合、そちらでも MULTI 開始
$cluster->get('user:2000');

// exec の戻り値は常に配列。一部ノードで失敗しても全体としては成功とみなされ、
// 失敗した部分は false になる。
var_dump($cluster->exec());

パイプラインの非サポート

$result = $cluster->mget([
    '{session}abc123',
    '{session}def456',
    'standalone:key'
]);

// キーのハッシュ先ノードに対して PING
$cluster->ping('user:1234');

// 特定ノード（ホスト＋ポート）に対して INFO 取得
$cluster->info(['192.168.1.10', 7000]);

// 全マスタノードに対して CONFIG GET maxmemory を実行
foreach ($cluster->_masters() as $master) {
    $config = $cluster->config('GET', 'maxmemory', $master);
    echo "Node " . implode(':', $master) . ": $config\n";
}

session.save_handler = rediscluster
session.save_path = "seed[]=10.0.0.1:7000&seed[]=10.0.0.2:7000&timeout=2.5&read_timeout=2&failover=error&persistent=1"