CodeIgniter4多驱动缓存配置教程

本文深入解析了CodeIgniter4多驱动缓存（文件与Redis）的实战配置要点与避坑指南：明确Redis因高性能和自动过期机制成为生产环境首选，而文件驱动仅适合本地开发或低流量场景；强调配置修改后必须清除writable/cache并重启应用才能生效，指出$ttl必须显式传整数、缓存键须强制添加作用域前缀且严禁明文存储敏感信息，并揭露常见部署陷阱（如Docker中host误写localhost、扩展装错为predis而非redis）。每一条建议均源自真实踩坑经验，直击线上缓存失效、键冲突、配置不生效等高频痛点，助你一步到位构建稳定、安全、高效的缓存体系。

缓存驱动怎么选：文件 vs Redis 的实际取舍

文件缓存开箱即用，但并发高或数据量大时容易锁文件、读写慢；Redis 缓存响应快、支持过期自动清理，但得额外部署服务、网络调用有延迟。选哪个不看文档推荐，看你的部署环境和数据特征。

• 本地开发、小流量后台系统，file 驱动足够，配置零成本
• 用户会话、API 响应缓存、高频查询结果，必须上 redis，否则 file 会在并发下返回陈旧或空值
• redis 驱动依赖 ext-redis 扩展，不是 ext-predis —— 装错扩展会报 Class 'Redis' not found
• 若用 Docker，确保 PHP 容器能连通 Redis 容器，常见坑是 host 写成 localhost（实际该填 redis 服务名）

config/Cache.php 怎么改才生效

CodeIgniter4 的缓存配置不是改完就热加载，它只在应用启动时读一次。改了 app/Config/Cache.php 后必须清掉 writable/cache 下的已编译配置缓存，否则新配置被忽略。

• 关键配置项是 $handler（驱动名）、$backupHandler（降级兜底驱动）、$redis 数组里的 host/port/database
• 别碰 $prefix 默认值 —— 改了会导致旧缓存键完全失效，线上切勿随意动
• 如果启用了 APCu 作为主驱动，注意它只在单个 PHP 进程内有效，FPM 场景下各 worker 不共享，不适合跨请求缓存
• 修改后运行 php spark cache:clear，再删 writable/cache/config/ 目录下所有文件

CacheInterface::save() 的第三个参数到底要不要传

这个参数是 $ttl（time-to-live），单位秒。不传 ≠ 永不过期，而是走配置里 $defaultTime 的默认值（默认 300 秒）。线上出问题常因这里没显式设值，导致缓存比预期早失效。

• 查数据库结果缓存，建议显式传 3600（1 小时）或更短，避免脏数据滞留
• 用户登录态、临时 token，必须传精确值，比如 900（15 分钟），不能依赖默认
• 传 0 表示“永不过期”，但 Redis 里实际是用 SET 而非 SETEX，文件驱动则靠文件修改时间判断，不可靠 —— 别这么用
• 注意：$ttl 是整数，传浮点数（如 30.5）会被截断为 30，不会报错但逻辑失准

缓存键命名为什么总撞车

缓存键（key）不是随便拼字符串就行。CI4 对 key 有长度限制（Redis 默认 255 字节）、非法字符过滤（如空格、控制符会被转义或截断），更麻烦的是不同业务模块用相似 key 格式，比如都用 user_123，一不小心就互相覆盖。

• 强制加作用域前缀，比如 api_user_profile_123、admin_user_list_page2
• 避免直接拼变量进 key，用 hash_hmac('sha256', $rawKey, $salt) 生成固定长 key，防超长和特殊字符
• 别把敏感信息（如手机号、token）明文塞进 key —— Redis 日志、监控可能泄露
• 调试时用 $cache->getKeys()（仅 file 和 redis 支持）快速扫一遍当前有哪些 key，比翻日志快得多

缓存键一旦设计错，修复成本远高于初期多花两分钟想清楚格式。线上跑着的 key 没法批量 rename，只能等自然过期或手动 flush —— 这事没法补救。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《CodeIgniter4多驱动缓存配置教程》文章吧，也可关注golang学习网公众号了解相关技术文章。