CodeIgniter 4 Redis 缓存配置详解及疑难解答
许多 CodeIgniter 4 开发者在使用 Redis 作为缓存后端时遇到问题。本文将详细讲解如何在 CodeIgniter 4 中正确配置和使用 Redis，并解决常见问题，例如修改 app/config/cache.php 后 Redis 仍然无法生效的情况。
问题：Redis 配置无效
修改 app/config/cache.php 中的 Redis 配置后，Redis 仍然没有被使用，这是为什么？是否需要安装 PHP Redis 扩展？
解答：
仅修改 app/config/cache.php 是不够的。正确配置和使用 CodeIgniter 4 的 Redis 缓存需要以下步骤：
-
安装 PHP Redis 扩展: 这是关键的第一步！确保你的服务器已安装 PHP 的 Redis 扩展。在 Linux 系统中，可以使用以下命令安装 (具体命令可能因发行版而异):
sudo apt-get install php-redis # 或其他适合你系统的包管理器命令
安装后，务必重启你的 PHP 服务。
-
配置
app/config/cache.php: 打开app/config/cache.php文件，正确配置 Redis 连接参数：public $redis = [ 'host' => '127.0.0.1', 'password' => null, // 如果你的 Redis 设置了密码，请填写 'port' => 6379, 'timeout' => 0, 'database' => 0, // 选择 Redis 数据库 ];至关重要的一步: 将
$handler属性设置为'redis'，明确指定使用 Redis 作为缓存后端：public $handler = 'redis';
-
使用 CodeIgniter 4 缓存服务: 配置完成后，你可以通过 CodeIgniter 4 的缓存服务访问 Redis：
$cache = \Config\Services::cache(); $cache->save('mykey', 'myvalue', 300); // 保存缓存，300 秒后过期 $value = $cache->get('mykey'); // 获取缓存
故障排除：
如果仍然无法使用 Redis，请检查以下内容：
- Redis 服务: 确保 Redis 服务已启动并正常运行。
-
Redis 配置: 仔细检查
app/config/cache.php中的 Redis 配置，确保host、port和password与你的 Redis 服务器配置完全一致。 -
PHP Redis 扩展: 使用
phpinfo()函数验证 PHP Redis 扩展是否已正确安装和加载。 - 防火墙: 确保你的服务器防火墙没有阻止 PHP 进程访问 Redis 端口 (通常是 6379)。
通过以上步骤和排查，你应该能够在 CodeIgniter 4 中成功配置和使用 Redis 缓存。
