Yii2Session 切换 Redis 存储，多实例部署 session 共享配置-php教程-PHP中文网

yii2多实例部署必须用redis等集中式存储替代文件session，否则用户跨节点会反复登录；需安装phpredis扩展和yii2-redis包，配置redis组件与session组件并复用连接，指定database、keyprefix和timeout，最后验证key写入与登录态一致性。

yii2session 切换 redis 存储，多实例部署 session 共享配置

Yii2 应用在多实例（如 Nginx 负载均衡后接多个 PHP-FPM 实例）部署时，必须将 session 存储从默认的文件方式切换为集中式存储，否则用户在不同节点间跳转会反复登录。Redis 是最常用、稳定且高性能的选择。

一、确认 Redis 扩展已安装并可用

确保服务器已安装 phpredis 扩展（非 predis），并在 phpinfo() 中可见；同时通过 Composer 安装 Yii2 官方 Redis 扩展：

composer require --prefer-dist yiisoft/yii2-redis
检查 vendor/yiisoft/yii2-redis 目录存在，且类 yii\redis\Session 可被自动加载
确认 Redis 服务运行正常，能被 PHP 进程访问（注意防火墙、SELinux、host 配置）

二、配置 redis 组件（复用已有连接）

在 config/main.php 或 config/web.php 的 'components' 数组中添加或复用 redis 连接：

'redis' => [
    'class' => 'yii\redis\Connection',
    'hostname' => '192.168.1.100',  // 生产环境建议用内网 IP
    'port' => 6379,
    'database' => 1,                // 建议与 cache 分库，例如 cache 用 db 0，session 用 db 1
    'password' => 'your_redis_pass', // 若启用认证
],

⚠️ 注意：database 必须明确指定，不能依赖默认值；不同应用或模块使用不同 database 可避免 key 冲突。

三、启用 Redis Session 存储

替换默认 session 组件，指向 Redis 后端：

Session Cost Tracker

通过记录任务、价值与Token消耗，追踪并分析AI会话的投入产出比，从而优化效率、减少无效劳动。

下载

'session' => [
    'class' => 'yii\redis\Session',
    'redis' => 'redis',  // 指向上面定义的 redis 组件 ID（字符串名）
    'keyPrefix' => 'sess:', // 可选，避免与其他应用 session key 混淆
    'timeout' => 1440,      // 单位：秒，与 PHP ini 中 session.gc_maxlifetime 保持一致
],

关键点说明：

'redis' => 'redis' 表示复用 components 中名为 redis 的连接配置，无需重复写 hostname/port
keyPrefix 会自动加在每个 session ID 前，例如 sess:abc123xyz，推荐设置
timeout 必须 ≥ 应用中设置的 session.gc_maxlifetime（通常在 php.ini 或 ini_set() 中），否则会提前失效

四、验证与注意事项

完成配置后重启 Web 服务，进行以下验证：

登录后查看 Redis 中是否生成带 sess: 前缀的 key：redis-cli -a yourpass SELECT 1; KEYS "sess:*"
在两个不同后端实例上访问同一页面，确认登录态持续有效（可临时在 index.php 加日志输出 session_id() 和 Yii::$app->user->isGuest）
检查日志是否有 Failed to write session data 或 Connection refused 类错误

常见问题提示：