Yii 中多版本控制器的实现

需求:浏览器访问 reports/daily 时,使其默认转到 v1 版本,若 URL 参数带有版本参数 version,则转到对应的版本代码。

  • reports/daily -> modules/reports/controllers/v1/DailyController.php
  • reports/daily?version=v2 -> modules/reports/controllers/v2/DailyController.php

目录结构如下:

vbnet 复制代码
modules/
├── reports/
│   ├── controllers/
│   │   ├── v1/
│   │   │   └── DailyController.php
│   │   └── v2/
│   │       └── DailyController.php
│   └── views/
│       ├── v1/
│       │   └── daily/
│       │       └── index.php
│       └── v2/
│           └── daily/
│               └── index.php
└── Module.php

首先,修改 Module.php 文件,在模块初始化时从 URL 中解析 version 参数

php 复制代码
// Module.php
public function init()
{
    parent::init();

    $version = $this->getVersionFromQueryString();
    // 修改命名空间
    $this->controllerNamespace = sprintf('app\modules\reports\controllers\%s', $version);
}


protected function getVersionFromQueryString(): string
{
    $request = \Yii::$app->request;
    $version = $request->get('version', 'v1');
    if (!in_array($version, ['v1', 'v2'])) {
        $version = 'v1';
    }
    return $version;
}

此外,还需重写模块获取视图路径的方法

php 复制代码
// Module.php
public function getViewPath(): string
{
    return $this->basePath . '/views/' . $this->getVersionFromQueryString();
}

若不重写获取视图路径方法,加载视图时需要指定详细路径 $this->render('@reports/views/v1/daily/index'),非常麻烦!

控制器代码如下

php 复制代码
// v1/DailyController.php
namespace app\modules\reports\controllers\v1;

use yii\web\Controller;

class DailyController extends Controller
{
    public function actionIndex(): string
    {
        // 只需要 index 即可找到对应控制器的视图
        return $this->render('index');
    }
}

完工。

相关推荐
布列瑟农的星空6 分钟前
大话设计模式——关注点分离原则下的事件处理
前端·后端·架构
现在就干1 小时前
Spring事务基础:你在入门时踩过的所有坑
java·后端
该用户已不存在2 小时前
Gradle vs. Maven,Java 构建工具该用哪个?
java·后端·maven
JohnYan2 小时前
Bun技术评估 - 23 Glob
javascript·后端·bun
二闹2 小时前
聊天怕被老板发现?摩斯密码来帮你
后端·python
用户298698530142 小时前
# C#:删除 Word 中的页眉或页脚
后端
David爱编程2 小时前
happens-before 规则详解:JMM 中的有序性保障
java·后端
小张学习之旅2 小时前
ConcurrentHashMap
java·后端
PetterHillWater3 小时前
阿里Qoder的Quest小试牛刀
后端·aigc
程序猿阿伟3 小时前
《支付回调状态异常的溯源与架构级修复》
后端·架构