Docker+Nginx+Yii2高级模板整合Redis时前后端共享会话失效求助

根因定位 #

1. 子应用配置覆盖公共配置：frontend/config/main.php和backend/config/main.php中的session配置指定了savePath = sys_get_temp_dir()，且未显式声明redis会话驱动，优先级高于common层的redis会话配置，导致实际仍使用文件存储会话，与预期的redis存储逻辑冲突
2. PHP.ini会话配置无效：php.ini中使用的${SESSION_HANDLER}等环境变量占位符默认不会被PHP解析，同时PHP原生会话配置与Yii框架的会话组件逻辑冲突
3. 会话cookie作用域未显式配置：未指定cookie的path和domain，可能导致前后端跨路径无法读取同一会话cookie

修复步骤 #

1. 修正前后端子应用的session配置 #

删除frontend/config/main.php和backend/config/main.php中session配置的savePath参数，显式指定redis会话驱动，并统一cookie作用域，前后端session配置需保持完全一致：

'session' => [
    'class' => 'yii\redis\Session',
    'name' => 'advanced-backend-frontend',
    'cookieParams' => [
        'path' => '/',
        'domain' => 'proj5.local',
        'httpOnly' => true, // 开启可提升安全性，不影响会话共享
    ],
],

2. 修正前后端子应用的identityCookie配置 #

统一身份cookie的作用域，与会话cookie配置保持完全一致：

'identityCookie' => [
    'name' => 'backend-same-frontend',
    'httpOnly' => true,
    'path' => '/',
    'domain' => 'proj5.local',
],

3. 清理冲突的PHP.ini配置 #

删除frontend/web/php.ini中的所有session相关配置，Yii的redis Session组件会自行处理会话存储逻辑，不需要依赖PHP原生的session配置，避免冲突。同时可以删除docker-compose.yml中php服务的SESSION_*开头的环境变量，不再需要。

4. 验证redis连接有效性 #

启动服务后可在应用中执行以下代码验证redis连接正常：

var_dump(\Yii::$app->redis->ping());

正常应返回字符串PONG，如连接失败检查.env文件中的REDIS_PORT、REDIS_PASSWORD参数是否配置正确。

5. 验证会话存储 #

登录应用后进入redis容器执行以下命令，确认会话数据已写入redis：

redis-cli -a 你的redis密码 keys "yii:session:*"

如返回对应会话key则说明redis存储生效，否则检查session组件配置是否正确。

内容的提问来源于stack exchange，提问作者José Ari Junior