phpredis扩展未正确加载或配置导致Class 'Redis' not found等错误，需通过包管理器安装、验证版本兼容性、检查PHP模块与配置路径、合理设置连接参数及序列化方式，并复用连接避免资源耗尽。
phpredis 扩展没装上，phpinfo() 里找不到 Redis 模块
常见现象是 new Redis() 报错 Class 'Redis' not found，或者 extension=redis.so 加了但 PHP 启动失败。核心原因不是“没下载”，而是扩展没被正确编译、加载或版本不匹配。
- Linux 下优先用包管理器安装：
apt install php-redis（Debian/Ubuntu）或yum install php-pecl-redis（CentOS/RHEL），避免手动编译出错 - 确认 PHP 版本和扩展兼容性：PHP 8.0+ 需用 phpredis 5.3.7+，旧版如 4.x 不支持 JIT 或某些新类型
-
php -m | grep redis和php --ri redis必须同时成功，后者能显示实际加载的 ini 文件路径，检查是否被其他配置覆盖 - 如果用 Docker，别只改
Dockerfile里的一行pecl install redis，还要确保docker-php-ext-enable redis执行成功，且容器重启后生效
connect() 超时或拒绝连接，但 redis-cli -h 能通
不是 Redis 服务问题，而是 PHP 客户端默认行为和网络环境不匹配。常见于 Docker、云主机或防火墙隔离场景。
- 默认
connect()使用 TCP，超时仅 1 秒，建议显式设参：$redis->connect('127.0.0.1', 6379, 3.0)，第三个参数是超时秒数（float） - 本地开发用
127.0.0.1，别用localhost——它可能触发 DNS 解析或 IPv6 回环，尤其在 /etc/hosts 未配时容易卡住 - Docker 容器间调用，宿主机 IP 写
host.docker.internal（Docker Desktop）或宿主机真实内网 IP，绝不能写127.0.0.1（那是容器自己） - 阿里云等 ECS 实例，安全组必须放行 6379 端口，且 Redis 配置里
bind不能只写127.0.0.1，要加内网 IP 或注释掉
存数组或对象时变成空值或报错 ERR wrong number of arguments
phpredis 默认不序列化，直接把 PHP 结构丢给 Redis，而 Redis 只认字符串。这不是 bug，是设计如此。
- 简单值用
set()没问题，但数组、对象必须先序列化：$redis->set('key', json_encode($data))或serialize($data)，取的时候对应json_decode($redis->get('key'), true) - 别用
hSet()存整个数组——它只接受 string field + string value，hMset()才批量写 hash，且传入必须是关联数组：$redis->hMset('user:1', ['name' => 'a', 'age' => '20']) -
lPush()/rPush()只接受单个字符串元素，想推数组得循环或用lPush($key, ...$array)（PHP 5.6+ 展开语法） - 如果启用了
redis.serializer = php（php.ini 中），那set()会自动序列化，但不推荐——跨语言兼容性差，且 PHP 版本升级可能导致反序列化失败
连接池没实现，短生命周期脚本频繁 new Redis() 导致 TIME_WAIT 爆满
CLI 脚本或 FPM 模式下反复 new、connect、close，系统级 socket 资源会被快速耗尽，表现为 “Cannot assign requested address” 或响应变慢。
立即学习“PHP免费学习笔记（深入）”；
- phpredis 本身不提供连接池，靠复用实例。FPM 场景下应将
Redis实例作为全局或 DI 容器单例，而非每次请求都 new - CLI 脚本（如队列消费者）务必在循环外初始化连接，并用
$redis->ping()做心跳检测，断连后重连，而不是每次操作前都 connect - 不要依赖析构函数自动 close——PHP GC 不保证及时执行，
unset($redis)也不等于释放 socket；明确调用$redis->close()或让脚本自然结束更稳妥 - 高并发下考虑用
pconnect()（持久连接），但它在 FPM 中有风险：子进程继承父进程连接，可能连错 DB 或权限失效，需配合setOption(Redis::OPT_PREFIX, 'myapp:')隔离上下文
Redis 连接不是“打开即用”，从扩展加载到数据落地，每一步都有隐含约束。最常被跳过的其实是连接复用和序列化策略——这两点不提前对齐，后面加监控、切集群、换存储都会踩二次坑。
