直接用composer require predis/predis安装即可，Predis是纯PHP实现，无需编译扩展或配置php.ini；若报Class 'Predis\Client' not found，需检查自动加载是否生效、vendor/autoload.php路径是否正确、配置键名是否全小写（如timeout而非Timeout），并确认Redis服务可达且参数无解析错误。
直接用 composer require predis/predis 就行，别折腾扩展编译、php.ini 配置或 redis:// URL 解析——Predis 是纯 PHP 实现，装完即用。
Class 'Predis\Client' not found 怎么办
这不是 Predis 没装好，而是自动加载没触发或被覆盖：
- 先跑
composer dump-autoload，尤其在手动改过composer.jsonautoload 后 - 确认没在项目中自定义 PSR-4 规则时把
vendor/目录包含进去（会覆盖 Composer 默认加载） - CI/CD 环境执行
composer install --no-dev，但本地开发别加这个参数，否则可能漏掉调试依赖 - 检查
vendor/autoload.php是否真实存在，且路径拼写没错（比如require 'vendor/autoload.php';不能写成require './vendor/autoload.php';在某些 CLI 工作目录下会失败）
Predis\Client 构造函数传参必须注意的键名大小写
填错字段名不会报错，而是静默退回到默认值（比如 timeout 写成 Timeout，实际连接超时变成 0，请求卡死）：
- 必须小写的配置项：
timeout、read_write_timeout、retry_interval - 标准字段：
scheme、host、port、password、database - 密码含
@或/？得先rawurlencode()，再拼进host或password字段，否则解析截断 - 集群模式必须传数组：
['tcp://127.0.0.1:7000', 'tcp://127.0.0.1:7001']，并显式开启'replication' => 'predis'或'cluster' => 'redis'
$client->get() 返回 null 到底是不是出错了
null 是正常返回值，只表示 key 不存在；它和连接失败、认证失败、命令拒绝完全无关：
立即学习“PHP免费学习笔记（深入）”；
- 连通性必须单独验证：
$client->ping()返回+PONG才算真正通了 - 捕获异常要用
Predis\Connection\ConnectionException，不是Exception泛捕 - 如果
get()返回null但业务逻辑预期一定有值，优先查 Redis 侧是否真没写入（用MONITOR命令看客户端发了啥 key） - 管道（pipeline）模式下，
get()返回的是结果数组里的对应位置值，不是单个字符串——别直接 echo
为什么本地连不上 Redis，但 redis-cli -h 127.0.0.1 能通
常见于 Docker 或 WSL 场景，根本原因不是密码或端口，而是 host 解析错位：
- PHP 容器里别写
'host' => 'localhost'，它指向容器自己，不是宿主机；该写'host' => 'host.docker.internal'（Docker Desktop）或宿主机 IP（Linux Docker） - WSL2 中 PHP 运行在 Windows，Redis 在 WSL，此时
127.0.0.1指向 Windows 本机，得用$(hostname -I | awk '{print $1}')查 WSL 的 IP 并填入 - Redis 配置里
bind只写了127.0.0.1？那外部网络请求必然拒绝，生产环境要配具体网卡 IP 或0.0.0.0（配合protected-mode no和密码） - 超时没设？加
'timeout' => 2.0, 'read_write_timeout' => 2.0，否则默认阻塞几秒才失败，调试时极难定位
最易被忽略的一点：Predis 默认对值做 serialize()，如果你存的是 JSON 字符串，取出来再 json_decode() 就多套了一层；要么统一用 JSON 编解码，要么初始化 Client 时指定 'serializer' => Predis\Serializer\None::class 关掉序列化——但之后只能存字符串。
