Yii框架Redis缓存怎么用_Yii框架高速缓存驱动配置【加速】

想在Yii框架里用好Redis缓存，其实核心就三件事：装对扩展、配好组件、用对方法。听起来简单，但每一步都可能藏着坑，稍不注意，缓存就可能写不进、读不出，甚至和Session等数据互相污染，导致线上故障。

第一步：确保phpredis扩展已启用，且版本达标

Yii2的yii\redis\Cache组件底层依赖的是phpredis扩展（注意，不是predis或其他叫redis的扩展）。如果没装或者装错了，程序可能不会直接报错，甚至set()方法还会返回true，给人一种成功的假象。但等你用redis-cli去查，会发现key根本不存在。

怎么确认呢？几个命令帮你排查：

• 执行php -m | grep redis，输出里必须明确出现redis字样。
• 确认Redis服务端版本：redis-cli INFO | grep redis_version。版本必须不低于2.6.12，否则使用一些高级功能（如依赖EVAL命令的）时会报ERR unknown command 'EVAL'错误。
• Windows环境下，如果使用WAMP/XAMPP等集成环境，通常需要手动在php.ini中启用php_redis.dll，并通过phpinfo()页面确认redis模块已成功加载。

第二步：配置Cache组件，keyPrefix是防冲突的“安全带”

很多人会忽略keyPrefix这个配置，觉得麻烦。但恰恰是这个配置，是避免缓存键名冲突的刚需。如果不设置，所有缓存key都会“裸奔”存入Redis。当你和其他应用，或者Yii自身的Session、Asset管理共用同一个Redis实例时，极有可能发生键名覆盖。比如，你get('user_123')，读到的可能是其他应用写入的二进制数据，导致程序异常。

正确配置姿势如下：

• 在config/web.php的components里，显式声明前缀：'cache' => ['class' => 'yii\redis\Cache', 'redis' => [...], 'keyPrefix' => 'myapp_cache_']。
• 前缀建议包含应用名和环境标识，例如'prod_api_cache_'，这样可以彻底隔离开发、测试、生产环境的数据，避免误操作导致脏读。
• 别指望用命名规范（如user:123）来代替keyPrefix。因为Yii内部会对key进行hash处理，你设置的user:123，最终存入Redis的key可能是myapp_cache_:5a7f:user:123这样的格式。

第三步：使用方法有讲究，细节决定成败

组件配好了，调用时也有几个关键点需要注意，否则依然会掉坑里。

Cache::get()返回false，不一定代表缓存未命中

这是最常见的误解之一。get()方法返回false，除了key不存在，还可能意味着序列化失败、值被压缩损坏，或者你直接用phpredis客户端连接，却误判了igbinary序列化格式的数据。

排查思路：

• 先用redis-cli查看原始值：get "myapp_cache_:user_list"。如果返回的是类似"\x00\x00\x00"的乱码，基本可以断定是序列化方式不匹配。
• Yii默认使用PHP自带的serialize。如果你想改用igbinary（性能提升约20%），必须确保所有读写该缓存的PHP环境都启用了igbinary扩展，并且在Cache组件配置中明确设置'serializer' => 'igbinary'。
• 在代码中判断缓存是否存在时，不要直接=== false。因为缓存里可能实际存储了一个布尔值false。更稳妥的做法是：if (($val = Yii::$app->cache->get($key)) === false && !Yii::$app->cache->exists($key)) { // 真正未命中 }。

Redis集群配置，不能照搬单节点写法

如果你的Redis是集群模式，配置写法完全不同。继续使用单节点的'hostname'和'port'配置，会导致所有连接都指向集群的第一个节点，分片功能完全失效，还可能因为槽位迁移而收到MOVED错误。

集群的正确配置方式：

• 删掉redis配置项下的hostname和port。
• 改用'clusters' => ['192.168.1.10:6379', '192.168.1.11:6379']这样的数组格式，列出集群的所有节点地址。
• 注意，redis子项的class仍然是'yii\redis\Connection'，不需要改成什么Cluster类——Yii2内部会根据clusters字段的存在自动切换为集群连接逻辑。
• 当然，前提是你的Redis集群各节点已经通过CLUSTER MEET命令组建好，并且分配好了slot。Yii2只负责客户端的路由，不负责集群的初始化。

最后，还有一个极易被忽略的“冷知识”：keyPrefix和serializer这两个配置项，一旦在Cache组件定义时设置好，就无法在运行时动态覆盖。也就是说，哪怕你在控制器里临时执行Yii::$app->cache->keyPrefix = 'tmp_'，也是无效的。因为key的最终生成逻辑，发生在组件初始化阶段，而不是每次调用时。这一点，在规划多租户或复杂缓存策略时需要特别注意。