php连接redis失败八成是环境配置问题：扩展未启用（php -m | grep redis无输出）、cli与web使用不同php.ini、连接超时未显式设置（需$redis->connect(host, port, timeout)）、存数组对象未序列化（应json_encode）、read_timeout未设导致read error on connection。
PHP 连接 Redis 出问题，八成不是代码写错了，而是环境或配置没对上。连接超时和序列化异常这两类最常出现，但原因其实很集中，解决起来也不难。
扩展没启用是连接失败的根源
Class 'Redis' not found 或 Call to undefined function redis_connect()，基本可以断定 PHP 根本没加载 redis 扩展。
- 运行 php -m | grep redis，没输出就说明没启用
- 再执行 php --ri redis，能看加载路径和实际生效的 ini 文件，避免被其他配置覆盖
- Linux 下用 apt/yum 安装后，别忘了重启 php-fpm 或 Apache；Windows 要确认 php.ini 里有 extension=php_redis.dll 且文件真实存在
- CLI 和 Web 环境可能用不同 php.ini，用 phpinfo() 页面查 “Loaded Configuration File” 才准
连接超时要显式设参，不能依赖默认值
connect() 默认超时极短（约1秒），且不报错只返回 false，容易误判为“连上了但没数据”。
- 必须显式传第三个参数：$redis->connect('127.0.0.1', 6379, 2.5)，单位是秒，不能为 0
- 别用 localhost，改用 127.0.0.1，防止 DNS 解析走 IPv6（::1）导致卡住
- 云环境或 Docker 中，优先用内网 IP 而非域名，绕过 DNS 失败风险
- 每次操作前建议加校验：!$redis->isConnected() || $redis->ping() !== '+PONG'，避免静默失效
存数组或对象必须手动序列化
Redis::set() 只接受字符串。直接传数组、对象、null 会静默转为空字符串，缓存看似写入成功，取出来却是空的。
- 简单值（字符串、数字）可直传：$redis->set('key', 'value')
- 数组/对象推荐用 json_encode($data, JSON_UNESCAPED_UNICODE) 存，读取时加 true 得数组：json_decode($redis->get('key'), true)
- 避免用 serialize() 存带类名的数据，换环境反序列化易失败；也别用 var_export()
- 多机部署下，所有节点必须统一序列化方式，禁用 igbinary，确保 php.ini 中 redis.serializer = php
read error on connection 是连接已断的信号
这不是网络抖动，而是 socket 接收超时，常见于服务端阻塞（如 RDB 持久化）或持久连接未检测失效。
- read_timeout 建议设为 1.0 秒（普通操作），批量命令可调至 5.0 以上
- 用 $redis->setOption(Redis::OPT_READ_TIMEOUT, 1.0) 动态设置，比构造函数更灵活
- pconnect() 下该选项只在首次连接生效，重连后需重新 setOption
- 搭配 TCP 保活：$redis->setOption(Redis::OPT_TCP_KEEPALIVE, 60)，防 NAT 网关静默断连
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
