thinkphp8 配置 redis 缓存和 session 驱动，核心在于修改 config/cache.php 和 config/session.php 配置文件。在 cache.php 中将默认驱动设为 redis 并填写连接参数，即可让全局缓存使用 redis；在 session.php 中同样将驱动改为 redis，session 数据就会自动存储到 redis 中。确保已安装 topthink/think-redis 扩展包，并在 .env 文件中正确配置 redis 的 ip、端口和密码。
如何配置全局缓存驱动为Redis
要将 ThinkPHP8 的全局缓存切换为 Redis，需编辑 config/cache.php 文件。首先确认项目中已安装 composer require topthink/think-redis。接着，打开 config/cache.php，找到 stores 数组，添加或修改一个名为 redis 的配置项，指定类型为 redis 并填入主机、端口等信息。最后，将 default 字段设置为 redis。这样，所有调用 Cache::remember() 或 Cache::set() 的方法都会默认使用 Redis。
\u003c?php
// config/cache.php
return [
'default' => 'redis',
'stores' => [
'redis' => [
'type' => 'redis',
'host' => env('REDIS_HOST', '127.0.0.1'),
'port' => env('REDIS_PORT', 6379),
'password' => env('REDIS_PASSWORD', ''),
'select' => 0,
'timeout' => 0,
'expire' => 0,
'persistent' => false,
'prefix' => '',
],
],
];
在 .env 文件中对应设置环境变量：
立即学习“PHP免费学习笔记（深入）”；
由 ReMe 驱动的记忆管理系统，支持跨会话记忆持久化、自动应用用户偏好以及智能上下文压缩...
REDIS_HOST=127.0.0.1 REDIS_PORT=6379 REDIS_PASSWORD=
验证时，调用 Cache::set('test_key', 'value', 3600) 后，可通过 Redis CLI 执行 GET test_key 查看是否成功写入。若返回 (nil)，检查 host 和 port 是否正确，以及防火墙是否放行 6379 端口。
如何配置Session驱动为Redis
将 Session 存储至 Redis 可解决多服务器部署时的会话共享问题。操作方法是修改 config/session.php 文件。同样需要确保 topthink/think-redis 已安装。在 config/session.php 中，找到 stores 配置，添加 redis 驱动配置，内容与缓存配置类似。然后将 default 设为 redis。此外，还需确保 session.php 中的 auto_start 为 true（默认），以便自动启动 Session。
\u003c?php
// config/session.php
return [
'default' => 'redis',
'stores' => [
'redis' => [
'type' => 'redis',
'host' => env('REDIS_HOST', '127.0.0.1'),
'port' => env('REDIS_PORT', 6379),
'password' => env('REDIS_PASSWORD', ''),
'select' => 0,
'timeout' => 0,
'prefix' => 'sess:',
],
],
'auto_start' => true,
];
注意 prefix 设置为 'sess:' 有助于区分 Session 键与其他缓存键。测试时，在控制器中执行 session('user_id', 123)，然后登录 Redis 执行 KEYS sess:*，应能看到以 sess: 开头的键，其值为序列化后的 Session 数据。若未找到，检查 session.php 的 default 是否指向 redis，以及 Redis 服务是否正常运行。
Redis配置错误导致Session无法保存的典型原因是什么
当 Redis 配置错误导致 Session 无法保存时，最常见的原因是 config/session.php 中的 stores.redis 配置未被正确引用，或 default 字段未设置为 redis。另一个常见原因是 .env 文件中的环境变量未加载，导致 env('REDIS_HOST') 返回空值，从而连接失败。此外，如果 Redis 设置了密码但 password 字段为空，也会连接被拒。排查时，先检查 config/session.php 的 default 是否为 redis，再检查 stores.redis 下的 host、port、password 是否与 .env 一致。可通过在控制器中打印 config('session.stores.redis') 来确认配置是否生效。若配置正确但仍失败，检查 Redis 服务日志是否有拒绝连接记录，或使用 telnet 127.0.0.1 6379 测试网络连通性。
