Yii2本地Flash消息正常 Plesk线上服务器不显示问题排查

问题背景 #

• 同一份Yii2应用代码，本地XAMPP环境下Flash消息可正常展示，部署到基于Plesk面板的Linux线上服务器后Flash消息无法显示
• 排查过程中发现backend/config/main.php配置文件未定义session组件，不确定该配置项缺失是否为故障诱因
• 需要明确Linux服务器上session文件存储位置的定位方法，验证session是否正常生成

当前backend/config/main.php中components配置如下：

'components' => [
    'errorHandler' => [
        'errorAction' => 'site/error',
    ],
    'assetManager' => $assets,
    'authManager' => [
        'class' => 'yii\rbac\DbManager',
        // uncomment if you want to cache RBAC items hierarchy
        // 'cache' => 'cache',
    ],
    'urlManager' => [
        'rules' => [
            '<controller:\w+>/<action:[a-zA-ZöäüßÖÄÜ\-]+>/<id:\d+>' => '<controller>/<action>',
            '<controller:\w+>/<action:[a-zA-ZöäüßÖÄÜ\-]+>'          => '<controller>/<action>',
            '<controller:\w+>/<id:\d+>'                             => '<controller>/view',
        ],
    ],
],

已知环境信息：

• 本地XAMPP环境中session文件生成在Xamp/Temp目录下
• 尝试在Linux默认session路径/var/lib/php5/sessions下查找，未找到线上环境生成的session文件

注：刚开始学习Yii2框架，问题若偏基础请谅解

解答 #

未配置session组件是否为故障原因 #

不是直接原因。Yii2框架会默认加载yii\web\Session作为session组件，即使配置文件中没有手动声明，调用Flash相关操作时框架会自动初始化默认session实例。

该故障的核心诱因通常是Plesk环境下默认session存储目录权限不匹配：Plesk支持多版本PHP、多站点隔离，不同站点的PHP运行用户、session路径往往是独立配置的，默认全局路径经常会出现站点PHP进程无读写权限的问题，导致session无法写入，Flash数据随请求跳转后直接丢失。

Linux服务器定位session实际存储路径的方法 #

不要直接套用默认路径，按以下优先级获取准确路径：

• PHP探针验证（最准确）
  在站点web根目录新建临时文件session_check.php，写入以下内容：

  <?php
  echo "Current session save path: " . session_save_path();
  

  访问该文件即可直接输出当前web站点运行环境使用的session存储路径。如果需要看完整配置，也可以在文件里加phpinfo();，搜索session.save_path项即可看到对应配置。
• SSH命令查询
  如果有服务器SSH权限，执行和站点运行版本一致的PHP查询命令，例如站点使用PHP 8.2则执行：

  php8.2 -i | grep session.save_path
  

  注意不要直接执行php命令查询，Plesk默认安装多版本PHP，CLI版本的配置和站点使用的FPM版本配置通常不一致，查询结果不具备参考性。
• Yii2框架内打印
  可以在任意控制器动作中临时加入以下代码，访问对应路由即可拿到Yii2当前使用的session路径：

  var_dump(Yii::$app->session->getSavePath());
  exit;
  

修复方案 #

1. 拿到准确session路径后，检查目录权限，给站点对应的PHP运行用户（Plesk下通常是创建站点时生成的独立系统用户）添加该目录的读写执行权限即可恢复。
2. 更稳妥的方案是直接在Yii2配置中显式指定session存储路径，不依赖服务器全局配置，避免后续环境调整再次出问题，配置示例：

   'components' => [
       // 保留原有其他组件配置
       'session' => [
           'class' => 'yii\web\Session',
           'savePath' => '@app/runtime/session',
       ],
   ]
   

   配置前需要手动创建backend/runtime/session目录，确保web进程对该目录有读写权限。
3. 额外排查项：如果权限配置正常仍不生效，检查站点是否存在www/非www、http/https强制跳转时未正确传递session cookie，或cookie的domain、secure参数配置和实际访问域名不匹配，导致session ID无法跨请求传递。

内容的提问来源于stack exchange，提问作者Amir Dora.