Predis 是纯 PHP 实现的 Redis 客户端，通过 Composer 安装后，需初始化项目、引入自动加载器、实例化 Client 并配置连接参数，支持密码认证、哨兵集群及 Docker 环境适配。
如果您希望在 PHP 项目中通过 Composer 安装并使用 Redis 客户端扩展，Predis 是一个纯 PHP 实现的、无需编译扩展即可直接使用的轻量级 Redis 客户端库。以下是完成该操作的具体步骤：
一、确认环境并安装 Composer
在使用 Predis 前，需确保系统已安装 PHP（建议 7.4 及以上版本）和 Composer 包管理工具。Composer 是 PHP 的依赖管理工具，用于下载和管理第三方库。
1、访问 https://getcomposer.org/download/ 下载官方安装脚本 composer-setup.php。
2、在终端执行 php composer-setup.php 生成 composer.phar 文件。
3、将 composer.phar 移动至系统路径并设为可执行，例如执行 sudo mv composer.phar /usr/local/bin/composer。
4、运行 composer --version 验证是否安装成功。
二、在项目中初始化 Composer 并引入 Predis
若当前项目尚未初始化 composer.json 文件，需先创建基础配置；若已有 composer.json，则可跳过初始化步骤，直接添加依赖。
1、进入项目根目录，执行 composer init，按提示填写包名、描述、作者等信息，生成初始 composer.json。
2、执行 composer require predis/predis 命令，自动下载 Predis 最新稳定版并写入 composer.json 和 composer.lock。
3、确认 vendor/autoload.php 文件已生成，该文件是 Composer 自动加载机制的核心入口。
三、编写 PHP 代码连接并操作 Redis
Predis 不依赖 php-redis 扩展，所有操作均通过其客户端类完成。需引入自动加载器后实例化 Client 对象，再调用方法与 Redis 服务交互。
1、创建 test_redis.php 文件，内容以 require 'vendor/autoload.php'; 开头。
2、添加 use Predis\Client; 声明命名空间。
3、实例化客户端：使用 $client = new Client(['scheme' => 'tcp', 'host' => '127.0.0.1', 'port' => 6379]); 连接本地 Redis 服务。
4、执行基本命令，例如 $client->set('foo', 'bar'); 写入键值对，再用 echo $client->get('foo'); 输出验证。
四、配置连接参数支持认证与高可用场景
当 Redis 启用密码认证或部署为哨兵/集群模式时，Predis 支持多种连接选项配置，避免硬编码敏感信息或单点故障。
1、启用密码认证：在 Client 构造参数中加入 'password' => 'your_password' 字段。
2、连接 Redis 哨兵集群：传入 'replication' => 'sentinel' 及 'service' => 'mymaster'，并指定哨兵地址列表。
3、使用连接池增强并发能力：通过 Predis\Connection\Aggregate\PredisCluster 类构建集群连接对象（需显式 use）。
五、验证安装与运行时错误排查
常见问题包括连接拒绝、类未找到、权限不足等，需结合报错信息定位原因。
1、若提示 Class 'Predis\Client' not found，检查是否遗漏 require 'vendor/autoload.php'; 或路径不正确。
2、若提示 Connection refused，确认 Redis 服务正在运行，且 host/port 与 redis.conf 中 bind 和 port 配置一致。
3、若使用 Docker 环境，确保 PHP 容器与 Redis 容器处于同一网络，host 应设为容器服务名（如 redis）而非 127.0.0.1。
