Yii2缓存配置与优化全攻略

在 Yii2 应用中，合理配置缓存组件是提升数据读取性能、显著降低数据库压力的关键一步；本文系统梳理了 Redis（单节点与集群）、Memcached、APCu 和 DbCache 五种主流缓存后端的精准配置方法与易踩坑点——从扩展依赖校验、类名与参数的严格匹配，到集群模式下 hostname 的移除、memcached 扩展的正确选择、APCu 的适用边界以及 DbCache 的退化使用前提，每一步都直击生产环境常见配置失效问题，助你避开“缓存不生效”“写入静默失败”“多实例键冲突”等陷阱，真正让缓存成为应用性能的加速器。

如果您在 Yii2 应用中需要提升数据读取效率、降低数据库负载，则必须正确配置缓存组件。以下是针对不同缓存后端的多种配置方法：

一、配置 Redis 缓存组件（单节点）

Redis 单节点配置适用于中小规模应用，依赖 yii\redis\Cache 类，要求 Redis 服务版本 ≥2.6.12，且需启用 phpredis 扩展。

1、打开应用主配置文件 config/web.php 或 config/main.php，在 'components' 数组内添加 'cache' 键。

2、设置 'class' 为 'yii\redis\Cache'。

3、在 'redis' 子配置中，指定 'hostname'、'port'、'password'（若启用认证）和 'database'（默认为 0）。

4、可选配置 'keyPrefix' 以避免多应用共享同一 Redis 实例时的键冲突，例如设为 'myapp_v2_'。

二、配置 Redis 集群缓存组件

Redis 集群通过自动分片与故障转移提升可用性与扩展性，Yii2 使用 yii\redis\Cache 并配合集群连接类支持该模式，需确保所有节点运行正常且网络互通。

1、在 'cache' 组件配置中，保持 'class' 为 'yii\redis\Cache'。

2、将 'redis' 的 'class' 改为 'yii\redis\Connection'（非 Cluster 类，Yii2 内部自动识别集群模式）。

3、删除 'hostname' 和 'port' 字段，在 'clusters' 键下以数组形式列出全部节点地址，格式为 'host:port'，例如：['192.168.1.10:6379', '192.168.1.11:6379', '192.168.1.12:6379']。

4、确认各节点已启用 cluster-enabled yes 并完成握手与槽分配，Yii2 不负责集群初始化，仅作为客户端接入。

三、配置 Memcached 缓存组件

Memcached 适合高并发短生命周期缓存场景，Yii2 通过 yii\caching\MemCache 类集成，需启用 PHP 的 memcached 扩展（非 memcache 扩展）以获得完整功能支持。

1、在 'components' 中定义 'cache'，'class' 设为 'yii\caching\MemCache'。

2、在 'servers' 子项中，以数组形式配置一个或多个服务器，每个元素包含 'host'、'port' 和 'weight'（如 ['host' => '127.0.0.1', 'port' => 11211, 'weight' => 100]）。

3、务必避免使用已废弃的 yii\caching\MemCache 对应 memcache 扩展，否则调用 set($key, $value, $expire) 时传入非零过期时间会导致写入失败且无报错。

4、验证扩展是否生效：执行 php -m | grep memcached，输出应含 memcached 而非仅 memcache。

四、配置 APCu 缓存组件（本地内存）

APCu 是 PHP 进程内共享内存缓存，无网络开销，适合存储配置、路由映射等只读或低频变更数据，不适用于分布式部署环境。

1、确认 PHP 已加载 apcu 扩展，并在 php.ini 中启用 apc.enable_cli=1（如需 CLI 环境支持）。

2、在 'components' 中配置 'cache'，'class' 设为 'yii\caching\ApcCache'。

3、可选设置 'useApcu' 为 true（Yii2 2.0.14+ 默认启用）。

4、注意：APCu 缓存内容无法跨 PHP-FPM worker 进程实时同步，重启 FPM 后缓存清空，不适用于 session 或用户状态类数据。

五、配置数据库缓存组件（兼容性方案）

当无外部缓存服务可用时，可退化使用数据库表作为缓存后端，适用于开发或极低流量场景，性能显著低于内存型缓存。

1、执行 Yii2 提供的迁移命令生成缓存表：yii cache/flush-all 前需确保已运行 yii migrate --migrationPath=@yii/caching/migrations。

2、在 'components' 中配置 'cache'，'class' 设为 'yii\caching\DbCache'。

3、确保应用已配置有效的 'db' 组件，且数据库用户具备对 cache 表的 INSERT、UPDATE、SELECT 权限。

4、可选设置 'cacheTable' 指定自定义表名，默认为 cache；设置 'keyPrefix' 防止与其他应用冲突。

今天关于《Yii2缓存配置与优化全攻略》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！