PHP如何用Predis连接Redis实战教程

Predis连接Redis失败主因是Client构造参数错误：默认不支持redis:// URL，须用数组配置或显式启用；DNS解析、超时、序列化方式及连接复用不当亦常见。

用 Predis 连接 Redis 时连不上，先看 Predis\Client 构造参数对不对

绝大多数连接失败不是 Redis 没起，而是 Predis\Client 初始化时传了错误的连接信息。它不认 redis:// 前缀的 DSN（除非显式启用），默认只接受数组配置。

• 错： new Predis\Client('redis://127.0.0.1:6379') —— 默认不解析 URL，会报 Connection refused 或空异常
• 对： new Predis\Client(['scheme' => 'tcp', 'host' => '127.0.0.1', 'port' => 6379])
• 如果坚持用 URL，得加配置：new Predis\Client('redis://127.0.0.1:6379', ['parameters' => ['scheme' => 'tcp']])
• 密码必须显式传 'password' => 'yourpass'，redis://:pass@... 格式在旧版 Predis 中可能被忽略

执行 set() 或 get() 报 “Cannot assign requested address”

这通常是 DNS 解析失败或 host 写成了不可达域名（比如 localhost 在 Docker 容器里指向 127.0.0.1，但 Redis 并不在容器内）。

• 本地开发：优先用 'host' => '127.0.0.1'，别用 localhost
• Docker 场景：PHP 容器连 Redis 容器，host 应填 Redis 容器名（如 'host' => 'redis'），且确保在同一 network 下
• 超时要设：加 'timeout' => 2.0, 'read_write_timeout' => 2.0，否则默认阻塞很久才报错
• 检查 Redis 是否监听外网：bind 配置不能只有 127.0.0.1（生产环境除外），protected-mode no 要配合密码用

存数组或对象进 Redis，取出来变 null 或乱码

Predis 默认用 PHP 的 serialize()，但如果你手动 JSON 编码过，或者用了其他序列化方式，读取时没对应解码，就会出问题。

• 默认行为安全：直接 $client->set('key', ['a' => 1])，再 $client->get('key') 能正确还原数组
• 如果用了 json_encode() 存，就必须 json_decode($client->get('key'), true) 取，不能混用
• 注意 hSet() / hGetAll() 等哈希命令也遵循同样规则，值部分仍走序列化
• 不想序列化？传选项：new Predis\Client($config, ['serializer' => Predis\Serializer\None::class])，但此时只能存字符串

并发写入时出现数据覆盖或 ERR max number of clients reached

没做连接复用或连接池，每次请求都 new 一个 Predis\Client，短时间大量请求会耗尽 Redis 连接数（默认 10000，但 PHP-FPM 子进程多时很容易打满）。

• 必须复用 Client 实例：放到容器里、单例类中，或至少每个请求生命周期内只初始化一次
• 别在循环里反复 new：for ($i=0; $i<100; $i++) { $client = new Predis\Client(...); $client->set(...); } 是典型反模式
• 查当前连接数：redis-cli info clients | grep connected_clients
• 临时缓解可调 Redis 配置：maxclients 20000，但治标不治本

Predis 的坑基本集中在连接初始化、序列化约定和连接生命周期这三块，其他功能比如 pipeline、transaction、pub/sub 都很稳——前提是前面这几步没走歪。