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 Predis\Client()）：
$client = new Predis\Client([
'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 Predis\Client([...], [
'read_write_timeout' => 5.0,
'connection_timeout' => 2.0,
]);
集群节点多、延迟高时，connection_timeout 太小会导致频繁连接失败，但太大又拖慢故障感知——2–3 秒是较稳妥的起点。
