必须正确配置缓存组件:一、redis单节点需设yii\redis\cache类及hostname/port等;二、redis集群用clusters数组列节点,删hostname/port;三、memcached须用memcached扩展而非memcache;四、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' 防止与其他应用冲突。











