ThinkPHP Redis如何实现本地与Redis二级缓存-ThinkPHP-PHP中文网

thinkphp不支持开箱即用的「本地+redis」二级缓存，type=>'complex'仅定义多驱动而非自动降级；需手动实现先查本地（如数组/apcu）再查redis的读取逻辑，并统一管理key生命周期与失效同步。

thinkphp redis如何实现本地与redis二级缓存

ThinkPHP 本身不提供开箱即用的「本地 + Redis」二级缓存组合，必须手动组装。直接调用 Cache::store('redis') 只走 Redis；想先查内存再查 Redis，得自己写逻辑、控制流程和生命周期。

为什么不能直接用 `type => 'complex'` 实现二级缓存

ThinkPHP 的 type => 'complex' 配置（如 default + redis store）只是定义多个缓存驱动，并不自动串联读取顺序。它本质是「多选一」或「按需指定」，不是「先本地后远程」的 fallback 流程。比如：

Cache::store('redis')->get('key')

永远只查 Redis；Cache::get('key') 默认走 default 驱动（通常是 file），不会自动降级到 redis。

常见错误现象：配置了 complex 类型后仍出现高并发下 Redis 打满、本地缓存未生效，就是因为没重写读取逻辑。

手动实现两级读取：先查 Swoole Table / APCu / Runtime 数组，再查 Redis

推荐在控制器或服务类中封装一个统一读取方法，避开框架默认缓存链路的限制。以「运行时内存数组」为例（轻量、无需扩展）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

$localCache 声明为静态属性或使用 think\Cache 的 driver('simple')（TP6+ 支持）
读取时按顺序：查本地 → 命中则返回；未命中 → 查 Redis → 命中则写入本地并返回；都未命中则查 DB 并双写
注意本地缓存无自动过期，需手动比对 Redis 中的 TTL 或加时间戳字段

示例片段（TP5.1+）：

public function getWithLocalFallback($key, $ttl = 3600)
{
    // 1. 先查本地（简单数组模拟）
    static $local = [];
    if (isset($local[$key]) && time() get($key);
    if ($value !== null) {
        // 3. 写回本地（带过期时间）
        $local[$key] = ['value' => $value, 'expire' => time() + $ttl];
        return $value;
    }

    return null;
}