PHP操作Redis需确保扩展正确加载、选用原生Redis类并规范连接、手动序列化数据、检查返回值及捕获异常——否则易现Connection refused或乱码。
PHP 操作 Redis 不是“装个扩展就能用”，关键在连接管理、序列化策略和错误兜底——没处理好这三点，线上容易出 Connection refused 或数据读出来是乱码。
怎么确认 PHP 已正确加载 redis 扩展
别只看 phpinfo() 里有没有模块名，得验证实际可用性：
- 运行
php -m | grep redis，输出必须是redis（不是iredis或其他变体） - 检查
extension=redis.so（Linux/macOS）或extension=php_redis.dll（Windows）是否写在正确的php.ini里——CLI 和 Web SAPI 的配置文件常不同，用php --ini和phpinfo()分别确认 - 执行
php -r "new Redis(); echo 'OK';"，不报Class 'Redis' not found才算真正就位
用 Redis 类还是 Predis 类库
原生 Redis 类性能高、命令覆盖全，但不支持连接池和自动重连；Predis 是纯 PHP 实现，灵活但慢一截。生产环境优先选原生扩展：
- 连接实例用
$redis = new Redis();，不是new \Redis()（命名空间错会导致类找不到） - 连接后务必调用
$redis->connect('127.0.0.1', 6379, 2.5)，第三个参数是超时（秒），设太短会频繁断连，设太长会阻塞请求 - 如果 Redis 开了密码，必须紧接着调用
$redis->auth('your_password')，顺序不能颠倒，否则认证失败且无明确错误提示
存取数据时最常踩的序列化坑
PHP 原生 Redis 类默认不序列化，直接把数组/对象当字符串存进去，读出来就是 Array 或 O:8:"stdClass":0:{} 这种垃圾：
立即学习“PHP免费学习笔记（深入）”；
- 存数组前手动
json_encode($data)，取出来再json_decode($val, true)——这是最稳的方案 - 想用自动序列化？可以调
$redis->setOption(Redis::OPT_SERIALIZER, Redis::SERIALIZER_PHP)，但注意：PHP 序列化结果无法被其他语言解析，且不同 PHP 版本间可能不兼容 -
hSet/hGet等哈希操作只接受字符串值，传数组会静默转成Array字符串，务必先json_encode
如何安全地处理连接中断和命令失败
Redis 连不上、命令执行失败不会抛异常，默认返回 false，但很多开发者直接拿返回值当数据用：
- 所有写操作后检查返回值：
if ($redis->set('key', $val) === false) { /* 记日志、降级逻辑 */ } - 读操作尤其要防空：
$val = $redis->get('key'); if ($val === false || $val === null) { /* 缓存未命中，查 DB */ } - 不要依赖
ping()预检——它本身也可能失败；更可靠的是在业务逻辑里捕获连接异常，比如try { $redis->get('x'); } catch (RedisException $e) { /* 处理连接断开 */ }
Redis 连接是长连接，但网络抖动、服务重启、timeout 设置不合理都会导致连接失效；每次操作前不检查连接状态，又不设重试，问题往往在凌晨三点才爆发。
