tp/REDIS_SETUP.md

Redis 配置说明

1. 安装 Redis 扩展

在项目根目录执行：

composer require predis/predis

或者如果使用 phpredis 扩展（需要 PHP Redis 扩展）：

# 确保已安装 PHP Redis 扩展
# 然后直接使用，无需 composer 安装

2. 配置环境变量

在项目根目录创建 .env 文件（如果不存在），添加以下配置：

# Redis 配置
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0
REDIS_PREFIX=

# 缓存配置
CACHE_DRIVER=redis

# Session 配置
SESSION_DRIVER=redis
SESSION_PREFIX=

3. 配置文件说明

cache.php

• 默认缓存驱动已设置为 redis
• Redis 连接配置已添加

session.php

• Session 驱动已设置为 redis
• 使用 Redis 存储 Session

4. 使用说明

缓存使用

use think\facade\Cache;

// 设置缓存
Cache::set('key', 'value', 3600);

// 获取缓存
$value = Cache::get('key');

// 删除缓存
Cache::delete('key');

Session 使用

use think\facade\Session;

// 设置 Session
Session::set('key', 'value');

// 获取 Session
$value = Session::get('key');

5. 验证 Redis 连接

确保 Redis 服务已启动：

# Windows
redis-server

# Linux/Mac
sudo systemctl start redis
# 或
redis-server

测试连接：

redis-cli ping
# 应该返回 PONG

6. 注意事项

1. 如果 Redis 未安装或连接失败，可以临时将 CACHE_DRIVER 和 SESSION_DRIVER 改回 file
2. Redis 密码如果为空，可以不设置 REDIS_PASSWORD
3. REDIS_PREFIX 用于区分不同项目的缓存，建议设置