CodeIgniter连接Redis缓存教程

本文详解了在 CodeIgniter 4 中正确集成 Redis 缓存的完整实践路径，直击开发者常踩的五大陷阱：必须安装原生 ext-redis 扩展而非 predis、Docker 环境下 host 必须用服务名而非 localhost、Cache.php 配置后需手动清空 writable/cache/config/ 并执行 php spark cache:clear 否则配置不生效、save() 方法必须显式传入整数 TTL（浮点数会被截断、0 值不可靠）、缓存 key 必须加作用域前缀防冲突且严禁嵌入敏感明文——每一步都关乎缓存是否真正生效与线上稳定性，是 CI4 项目接入 Redis 不可跳过的避坑指南。

CI4 用 Redis 做缓存，不是配完 cache.php 就能跑通——漏掉 php spark cache:clear 或没清 writable/cache/config/，新配置根本不会生效。

CI4 中启用 Redis 缓存必须装对扩展

必须安装 ext-redis（不是 ext-predis），否则启动时会报 Class 'Redis' not found。Ubuntu/Debian 系统执行：sudo apt-get install php-redis；CentOS/RHEL 用 yum install php-pecl-redis。装完检查 php -m | grep redis，有输出才算成功。Docker 环境下，PHP 容器的 host 配置不能写 localhost，得填 Redis 服务名（如 redis），否则连不上。

app/Config/Cache.php 的关键字段怎么填

只改 $handler = 'redis' 不够，还得确保 $redis 数组里字段有效：

• 'host' => 'redis'（Docker）或 '127.0.0.1'（本地）
• 'port' => 6379（别漏端口）
• 'password' => null（若 Redis 有密码，填字符串，不是 'null'）
• 'database' => 0（多库隔离时有用，不填默认 0）

改完必须手动删掉 writable/cache/config/ 下所有文件，再运行 php spark cache:clear —— CI4 启动时只读一次配置，不清理就是旧配置在跑。

CacheInterface::save() 的 $ttl 参数不能省

$cache->save('key', 'value', 3600) 第三个参数 $ttl 是整数秒，不传就用配置里的 $defaultTime（默认 300 秒），线上常因此缓存提前失效。注意：

• 传浮点数如 30.5 会被截断成 30，不报错但逻辑偏移
• 传 0 表示“永不过期”，Redis 实际发 SET 命令，不可靠；文件驱动则依赖文件修改时间，更不准
• 高频查询结果建议显式设 3600 或 1800，用户 token 类建议精确到 900（15 分钟）

缓存键（key）命名容易踩的坑

CI4 对 key 长度有硬限制（Redis 默认 255 字节），空格、控制符会被过滤或截断。更常见的是撞车：比如用户模块和订单模块都用 user_123 当 key，互相覆盖。解决方法：

• 加作用域前缀，如 user:profile:123、order:status:456
• 避免拼接明文敏感信息（如手机号、token 原值）
• 不用动态生成长字符串作 key，优先哈希后截取（如 md5($uid . $params)[0,16]）

线上切记别动 $prefix 配置项——它一改，所有旧 key 全失效，等同于全量缓存击穿。

今天关于《CodeIgniter连接Redis缓存教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！