ThinkPHP 8.0 缓存 Redis 最佳用法【提速】

先给大家提个醒：ThinkPHP 8.0的Redis缓存真正提速的关键，不是“开了Redis”就完事，而是配置不漏项、用法不越界、降级不沉默。很多项目缓存“看似生效”，实则一直在走file驱动——这才是性能瓶颈最容易被忽视的根源。

必须手动填全 config/cache.php 参数

很多人以为在 .env 中设个 CACHE_STORE=redis 就万事大吉了，但TP8根本不认 REDIS_HOST、REDIS_PORT 这些环境变量。所有连接参数得老老实实写进 config/cache.php 的 stores['redis'] 数组里：

• host：字符串，比如 '127.0.0.1'，别留空也别注释
• port：整型，比如 6379，写成字符串就罢工
• database：整型，比如 0，必须指定，否则部分命令直接报错
• password 或 auth：ACL模式（Redis ≥6.0）用 auth，传统模式用 password
• timeout：建议 float 类型，比如 3.0，避免连接卡死
• persistent：高并发下务必设为 true，减少TCP握手开销

session 和 cache 必须物理隔离

别指望靠 prefix 来区分 session 和 cache，冲突风险太高。推荐的做法是物理隔离：

• cache 用 database => 0
• session 用 database => 1（需同步配在 config/session.php 的 store 数组中）
• config/session.php 不仅要写 'type' => 'redis'，还必须完整声明 'store' => [...]，否则直接报 Call to a member function setOptions() on null
• 告诉PHP别掺和：ini_set('session.gc_probability', 0)，防止Redis中session被误删导致用户莫名其妙登出

验证是否真连上 Redis

别天真了，日志没报错不代表真的连上了。最快的验活方式是：

• 运行 php think tinker
• 执行：(new thinkcachedriverRedis(config('cache.stores.redis')))->handler()->ping()
• 返回 +PONG 才算通；返回 false 或异常，说明配置有误或网络不通
• 现象预警：如果发现 Cache::set('x', 'y') 返回 true，但 Cache::get('x') 返回 null，十有八九已经静默降级为 file 驱动了

请求缓存要靠中间件激活

即使Redis配好了，GET请求也不会自动缓存。必须主动启用框架内置的请求缓存中间件：

• 确保 thinkmiddlewareCheckRequestCache 已注册到对应路由或全局中间件队列
• 控制器中可用 $this->cache(3600) 显式设置缓存时长
• 带查询参数的URL（如 ?id=5）会被完整计入 key，注意缓存粒度
• 避免在中间件前输出内容（如 header() 或提前调用 session_start()），否则缓存响应逻辑会被破坏