必须引入Predis客户端以替代ThinkPHP默认Redis扩展，它纯PHP实现、无需C扩展、支持Redis 3.0+全协议，提供单节点、哨兵高可用及原生Cluster集群三种配置方式。
如果您在ThinkPHP项目中需要替代默认Redis扩展以获得更灵活的集群、哨兵或高级连接能力，则必须引入Predis客户端——它纯PHP实现、无需C扩展依赖、原生支持Redis 3.0+全协议特性。以下是集成Predis并完成多种配置方式的详细步骤：
一、通过Composer安装Predis依赖
使用Composer是官方推荐且最稳定的集成方式，可自动处理自动加载与版本兼容性问题。
1、在项目根目录执行命令：composer require predis/predis:^1.1
2、确认vendor/autoload.php已由ThinkPHP自动引入（TP5/TP6均默认支持）
立即学习“PHP免费学习笔记（深入）”；
3、验证安装成功：在任意控制器中执行class_exists('Predis\Client')应返回true
二、手动引入Predis源码（适用于无Composer环境）
当服务器限制Composer或需离线部署时，可将Predis源码直接放入框架目录并调整命名规范以适配ThinkPHP自动加载机制。
1、从GitHub下载Predis源码（v1.1+）：https://github.com/nrk/predis/releases
2、解压后将整个predis文件夹复制至thinkphp/library/目录下
3、重命名thinkphp/library/predis/Autoloader.php为Autoloader.class.php
4、在控制器中调用\Predis\Autoloader::register()启用自动加载
三、单节点Redis连接配置
适用于开发测试或简单生产环境，支持TCP、UNIX socket及带认证的连接方式。
1、创建连接实例：$client = new \Predis\Client('tcp://127.0.0.1:6379');
2、带密码与数据库选择的数组配置：$client = new \Predis\Client(['host' => '10.0.0.1', 'port' => 6379, 'password' => 'abc123', 'database' => 1]);
3、使用URI字符串配置SSL连接：$client = new \Predis\Client('tls://redis.example.com:6380?ssl[verify_peer]=1&ssl[cafile]=/path/to/cert.pem');
四、Redis哨兵（Sentinel）高可用配置
通过哨兵自动发现主节点并实现故障转移，Predis内置sentinel连接模式，无需额外封装。
1、定义哨兵地址列表：$sentinels = ['tcp://10.0.0.1:26379', 'tcp://10.0.0.2:26379'];
2、指定主节点名称与连接选项：$options = ['replication' => 'sentinel', 'service' => 'mymaster'];
3、初始化客户端：$client = new \Predis\Client($sentinels, $options);
4、确保Redis Sentinel配置中sentinel monitor mymaster已正确声明主服务名
五、Redis Cluster原生集群配置
用于分片式大规模缓存场景，Predis支持Redis 3.0+原生Cluster协议，需显式启用cluster => 'redis'选项。
1、准备至少三个Redis节点地址（如7000/7001/7002端口）：$nodes = ['tcp://10.0.0.1:7000', 'tcp://10.0.0.1:7001', 'tcp://10.0.0.1:7002'];
2、设置集群模式参数：$options = ['cluster' => 'redis'];
3、初始化集群客户端：$client = new \Predis\Client($nodes, $options);
4、注意：所有写入key必须包含hash tag（例如{user:1001}:profile），否则Predis无法路由至对应slot
