优先选Redis驱动，因其响应快、支持自动过期；文件驱动仅适用于本地开发或小流量场景。配置修改后需清空writable/cache并重启应用，缓存键须加作用域前缀且避免明文敏感信息，$ttl必须显式传整数值。
缓存驱动怎么选：文件 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，一不小心就互相覆盖。
立即学习“PHP免费学习笔记（深入）”；
- 强制加作用域前缀，比如
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 —— 这事没法补救。
