composer怎么安装Redis集群版依赖包_composer引入predis库与连接配置【实操】

predis/predis 默认仅支持单机模式，需显式配置 cluster => ‘redis’ 及 nodes 列表才能启用 redis Cluster 支持，否则会连接失败或降级为单点模式。

composer 安装 Redis 集群版依赖，不能直接用 predis/predis 的默认单机配置——它原生支持集群，但必须显式启用并传入正确的服务列表和参数，否则会连接失败或降级为单点模式。

为什么 composer require predis/predis 不够用

predis/predis 默认只初始化单节点客户端；即使你写了多个 Redis 地址，不指定集群模式，它会把所有地址当主从结构处理，而非 Redis Cluster 拓扑。常见表现是：MOVED 或 ASK 重定向错误被忽略，命令返回空或报错 Connection refused（实际是连上了但没走集群路由）。

• 集群模式必须通过 cluster 选项显式开启，值为 redis
• 地址列表需是 tcp://host:port 格式数组，不能含密码（密码要单独配）
• 不支持在 DSN 中写 redis://:pass@host:port 形式用于集群发现

安装与基础连接配置（php + predis）

执行安装命令：

composer require predis/predis:^1.1

PHP 中初始化集群客户端示例（注意：不是 new PredisClient()）：

$client = new PredisClient([     'scheme' => 'tcp',     'cluster' => 'redis',     'nodes' => [         ['host' => '192.168.1.10', 'port' => 7000],         ['host' => '192.168.1.10', 'port' => 7001],         ['host' => '192.168.1.10', 'port' => 7002],         // 至少三个主节点（Redis Cluster 最小要求）     ],     'parameters' => [         'password' => 'your_cluster_password', // 若集群启用了 auth         'database' => 0,     ], ]);

关键点：

• cluster => 'redis' 是硬性开关，缺了就不是集群模式
• nodes 是真实运行中的 master 节点（可包含部分 slave，但 predis 会自动发现拓扑）
• 密码不能写在 host:port 字符串里，必须进 parameters

验证是否真走集群路由

执行一个带 key hash 的命令，观察是否自动跳转到对应 slot：

var_dump($client->get('user:1001')); // 正常返回值说明路由成功 var_dump($client->info('Cluster'));   // 应返回包含 cluster_enabled: 1 的数组

如果报错 ERR this instance has cluster support disabled，说明连的是非集群 Redis 实例；如果报 MOVED 12345 192.168.1.11:7001 且未自动重试，说明 cluster => 'redis' 没生效。

• 集群 key 必须含 {} 或满足 hash tag 规则，否则 predis 可能误判 slot
• 避免用 KEYS * 这类全节点扫描命令，predis 会随机发给某个节点并报错
• 事务（multi()）在集群下受限：所有 key 必须落在同一 slot，否则抛异常

常见踩坑点：密码、TLS、超时

Redis Cluster 开启了 requirepass，但 predis 对集群各节点分别认证，容易漏配或错配：

• 密码必须统一，且写在 parameters.password，不能靠 auth 命令手动触发
• TLS 不被原生支持：predis v1.x 的集群模式不解析 scheme => tls，需改用 stream 上层封装或换 phpredis
• 超时建议分开设：read_write_timeout 和 connection_timeout 都要设，集群网络抖动更敏感

超时配置示例：

$client = new PredisClient([...], [     'read_write_timeout' => 5.0,     'connection_timeout' => 2.0, ]);

集群节点多、延迟高时，connection_timeout 太小会导致频繁连接失败，但太大又拖慢故障感知——2–3 秒是较稳妥的起点。