Yii2.0.48 Session分布式存储配置【集群】-php教程-PHP中文网

在yii2.0.48中需将session从文件切换为redis集群存储以解决多机负载下会话丢失问题，须确保phpredis≥5.0并正确配置redis组件及自定义redisclustersessionhandler。

yii2.0.48 session分布式存储配置【集群】

在Yii2.0.48中将Session从文件存储切换为Redis集群存储，是解决多机负载均衡下会话丢失的刚性需求——用户登录后刷新页面即登出、购物车数据随机清空、后台权限校验失败，这些问题都源于默认FileSession无法跨服务器共享。

确认PHP与扩展支持

执行php -m | grep redis，确保输出含redis而非pdo_redis或predis；若无输出，需安装phpredis≥5.0（非Predis库），否则后续所有配置均会触发Class 'RedisCluster' not found致命错误。

运行php --ri redis，检查版本号是否≥5.0；低于此版本必须升级，旧版不提供RedisCluster类，无法实现集群分片路由。

配置Redis集群连接组件

打开config/web.php，在'components'数组内添加'redis'定义：

复制以下代码块，注意替换hostname和port为你实际的集群节点地址（至少3个主节点）：

'redis' => [
  'class' => 'yii\redis\Connection',
  'hostname' => 'redis-node1.example.com',
  'port' => 6379,
  'password' => 'your-cluster-password',
  'database' => 0,
  'clusters' => [
    'redis-node1.example.com:6379',
    'redis-node2.example.com:6379',
    'redis-node3.example.com:6379',
  ],
],

【'clusters'必须是数组，且每个元素格式为"host:port"，不能带tcp://前缀】。若误写为'tcp://node1:7000,tcp://node2:7001'，yii\redis\Connection将无法解析，启动时报Invalid cluster node format。

替换Session组件为集群适配版本

Yii2.0.48不内置Redis集群Session处理器，必须手动注册自定义SessionHandlerInterface实现类。

在项目根目录创建components/RedisClusterSessionHandler.php，内容如下：

Ai Coach Batch Session Summary

批量分析录音转写，输出多维度拓客报告。触发词：录音分析、总结、音频总结、拜访记录总结。当用户提及「分析录音」「看看录音数据」「最近的录音」「通话记录」且意图为批量统计/分析时触发。仅出现「录音」或「拜访」时需结合上下文，若仅查看单条详情则不触发。

下载

<?php
namespace app\components;
use SessionHandlerInterface;
class RedisClusterSessionHandler implements SessionHandlerInterface {
  private $cluster;
  private $prefix = 'yii2_session:';
  public function __construct(array $nodes) {
    $this->cluster = new \RedisCluster(NULL, $nodes);
  }
  public function read($id) {
    return $this->cluster->get($this->prefix . '{' . $id . '}') ?: '';
  }
  public function write($id, $data) {
    $key = $this->prefix . '{' . $id . '}';
    $lifetime = (int)ini_get('session.gc_maxlifetime');
    return $this->cluster->setex($key, $lifetime, $data);
  }
  public function open($savePath, $sessionName) { return true; }
  public function close() { return true; }
  public function destroy($id) { $this->cluster->del($this->prefix . '{' . $id . '}'); return true; }
  public function gc($maxLifetime) { return true; }
}

在config/web.php的'components'中注册该处理器：

'session' => [
  'class' => 'yii\web\Session',
  'handler' => [
    'class' => 'app\components\RedisClusterSessionHandler',
    'nodes' => [
      'redis-node1.example.com:6379',
      'redis-node2.example.com:6379',
      'redis-node3.example.com:6379',
    ],
  ],
  'timeout' => 3600,
],