在 yii2 的 backend 应用中，当前用户可以切换角色，希望在所有链接中一直具有一个 role=distributor 或者 role=management。视图中的链接实现 。如何实现？

1、现在切换角色为 distributor 的入口链接是后台首页：https://console.apply.local/?role=distributor

2、希望此入口网址中，所以的链接都自动添加上请求参数：role=distributor ，现在是没有的。如图1

图1

3、创建自定义 UrlManager 组件 重写 createUrl 方法，当网址上的角色参数为 distributor 或者 service 时自动附加当前角色参数。

<?php

namespace management\components;

use Yii;

class UrlManager extends \yii\web\UrlManager
{
    public function createUrl($params): string
    {
        $role = Yii::$app->request->get('role', 'management');
        if (in_array($role, ['distributor', 'service'])) {
            $params['role'] = $role;
        }

        return parent::createUrl($params);
    }
}

4、配置应用使用自定义 UrlManager 在 backend 配置文件中替换默认的 urlManager。

        'urlManager' => [
            'class' => 'management\components\UrlManager',
        ],

5、此入口网址中，所有的链接都自动添加上请求参数：role=distributor。符合预期。如图2

图2

6、但是，其中有几个链接 不应该添加上请求参数：role=distributor。恰是需要取消掉。如图3

图3

7、在生成链接时，手动加一个标志位 ‘_skip_role’ => true，然后在 createUrl() 中判断

<?php

namespace management\components;

use Yii;

class UrlManager extends \yii\web\UrlManager
{
    public function createUrl($params): string
    {
        if (!isset($params['_skip_role'])) {
            // 仅当 role 为 distributor|service 时，才支持参数 role
            $role = Yii::$app->request->get('role', 'management');
            if (in_array($role, ['distributor', 'service']) && !isset($params['role'])) {
                $params['role'] = $role;
            }
        } else {
            unset($params['_skip_role']); // 清除这个临时参数，避免出现在 URL 中
        }

        return parent::createUrl($params);
    }
}

8、在视图中按照如下方式使用，生成的 链接 符合预期。如图4

图4

<div class="col-6 mb-3 text-right">
        <a class="btn btn-warning btn-rounded" href="<?php echo Url::toRoute(['/', '_skip_role' => true]); ?>">管理 <?php echo $eventCount['management'];?></a>  <!-- / -->
        <a class="btn btn-danger btn-rounded" href="<?php echo Url::toRoute(['/', 'role' => 'distributor']); ?>">联络 <?php echo $eventCount['distributor'];?></a> <!-- /?role=distributor -->
        <a class="btn btn-purple btn-rounded" href="<?php echo Url::toRoute(['/', 'role' => 'service']); ?>">接待 <?php echo $eventCount['service'];?></a> <!-- /?role=service -->
    </div>