Yii2中如何在运行任意控制器前自动执行全局会话销毁函数

实现思路 #

Yii2原生提供应用级别事件，不需要修改任何现有控制器代码，就可以实现类似CodeIgniter钩子的全局前置执行效果，比在布局、父控制器中注入逻辑的耦合度更低，适配性更强。

具体实现步骤 #

• 第一步：先在你已有的助手类中补充会话销毁的逻辑
  你可以在HomeHelper中新增判断+销毁的公共静态方法，示例代码如下：

  <?php
  namespace app\helpers;
  
  use Yii;
  
  class HomeHelper
  {
      // 你原有的其他方法
      public static function getHelpDocUrlForCurrentPage()
      {
          // 原有逻辑
      }
  
      // 新增的全局会话销毁方法
      public static function handleSessionDestroy()
      {
          // 白名单配置：不需要触发会话销毁的路由，比如登录页、错误页等
          $whitelist = ['site/login', 'site/error', 'site/captcha'];
          if (in_array(Yii::$app->requestedRoute, $whitelist)) {
              return;
          }
  
          // 你的判断条件：会话超时、用户已登出等需要销毁全量会话的场景
          $isSessionInvalid = /* 你自己的业务判断逻辑，比如判断session里的过期时间戳、用户登录态 */;
          if ($isSessionInvalid) {
              // 销毁全量会话
              Yii::$app->session->destroy();
              // 执行重定向到首页，send()确保在事件阶段直接输出重定向头
              Yii::$app->response->redirect(Yii::$app->homeUrl)->send();
              Yii::$app->end();
          }
      }
  }
  

• 第二步：绑定应用全局beforeRequest事件
  打开你的应用配置文件（通常是config/web.php或者config/main.php），在根配置项中新增事件绑定：

  return [
      'id' => 'your-app-id',
      'basePath' => dirname(__DIR__),
      // 新增此行，绑定请求前置事件
      'on beforeRequest' => function ($event) {
          \app\helpers\HomeHelper::handleSessionDestroy();
      },
      // 其他原有配置项，比如components、modules、params等
      'components' => [
          // 原有组件配置
      ],
  ];
  

方案说明 #

beforeRequest是Yii2应用初始化完成后、控制器/动作执行前触发的全局事件，执行时机早于所有控制器的动作代码，完全满足你的需求。不需要修改100多个现有控制器，一次配置全局生效，后续调整逻辑只需要修改HomeHelper的对应方法即可。

你之前在布局中调用的方案不可行，是因为布局的渲染发生在控制器动作执行完成之后，逻辑触发时机太晚，无法拦截控制器动作的执行。

内容的提问来源于stack exchange，提问作者rajesh