php 8.5 连 redis cluster 必须用 predis 或 phpredis 8.0+，因原生不支持；需传多个 seed node、正确设置参数顺序与超时、使用哈希标签保证键路由一致，并手动处理故障转移后的连接重建。
PHP 8.5 连 Redis Cluster 必须用 Predis 或 phpredis 8.0+
PHP 8.5 原生不带 Redis Cluster 支持，ext-redis（即 phpredis）直到 6.0 版才实验性支持 Cluster，8.0+ 才真正稳定；而 Predis 是纯 PHP 实现，从 v1.1 起就支持 Cluster，且对 PHP 8.5 兼容无压力。
常见错误现象：RedisCluster::__construct(): supplied parameter is not a valid redis server array —— 多半是传了单节点地址、没按 Cluster 要求给多个 seed node，或用了老版本 phpredis（如 5.x）强行调 RedisCluster 类。
- 用
phpredis：确认已装pecl install redis-8.0.0或更高，php -m | grep redis输出含redis且php --ri redis显示 version ≥ 8.0.0 - 用
Predis：推荐 Composer 安装predis/predis:^1.1，它自动适配 PHP 8.5，无需扩展编译 - Cluster 初始化必须传 seed nodes 数组，例如
['127.0.0.1:7000', '127.0.0.1:7001']，不能只写一个地址
RedisCluster 构造时的参数顺序和选项很关键
phpredis 的 RedisCluster 类不像单例 Redis 那样靠 connect() 补救——构造失败就直接报错，且参数顺序固定、选项名敏感。
典型误用：new RedisCluster(null, ['127.0.0.1:7000']) 没设 timeout，结果卡死在重试；或把 read_timeout 写成 readTimeout，被静默忽略。
立即学习“PHP免费学习笔记（深入）”；
- 必需参数顺序：
RedisCluster::__construct(?string $name, array $seeds, int $timeout = 0, int $read_timeout = 0, bool $persistent = false, ?string $password = null) -
$timeout和$read_timeout单位是秒（非毫秒），设0表示无限等待，线上必须设为1.0或2.5这类浮点数 - 密码必须通过最后一个参数传，不能塞进 seed 字符串里（如
'redis://:pwd@127.0.0.1:7000'会解析失败） - 若集群启用了 ACL 用户（非 default），
$password实际应为"username:password"格式
分布式 Key 路由失效？检查 {} 包裹和哈希标签规则
Redis Cluster 不是“随机分片”，而是用 CRC16(key) % 16384 算槽位，但默认对整个 key 计算。如果业务中 key 没加 {} 哈希标签，关联数据（比如用户订单和用户信息）可能落在不同节点，MGET、事务、Lua 脚本就会失败。
错误现象：CROSSSLOT Keys in request don't hash to the same slot —— 就是这个原因。
- 强制同槽：把共用逻辑的 key 写成
user:{1001}:profile和user:{1001}:orders，花括号内内容相同，CRC16 结果就一样 - 花括号只能有一对，且不能嵌套；
user:{1001}:{orders}只认第一个{1001} - PHP 里拼接时别漏转义，
"user:{" . $uid . "}:profile"是错的，得写成"user:{{$uid}}:profile"或用双引号插值 + 大括号转义 - 没加哈希标签的 key 仍可存，但无法保证原子性操作，尤其涉及 pipeline 或 eval 时务必自查
故障转移后连接不自动恢复？得手动 catch + 重建实例
Redis Cluster 故障转移（如主节点宕机、从升主）后，phpredis 的 RedisCluster 实例不会自动刷新 slots 映射表，后续请求大概率报 MOVED 或 ASK 错误，然后抛出异常中断。
这不是配置问题，是客户端设计使然：phpredis 把 slots 缓存在实例内部，不轮询 CLUSTER SLOTS。
- 简单方案：捕获
RedisClusterException，检测错误信息是否含MOVED或ASK，然后unset($client)并新建RedisCluster实例 - 别依赖
try/catch包裹每个命令——开销大；建议在业务入口或 DAO 层统一做兜底重建 -
Predis默认带自动重定向（replication => 'cluster'），但 PHP 8.5 下需关掉throw_on_circular_redirect防止死循环 - 生产环境建议加一层轻量健康检查，比如定时
ping所有 seed node，发现不可达就主动重建 client
Cluster 的麻烦不在连不上，而在连上了却不知道它什么时候悄悄换了主从、挪了槽位、改了密码——这些细节 PHP 8.5 本身不帮你盯，得自己补。
