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');
    }
}

完工。

相关推荐
LaoZhangAI7 分钟前
GPT-5推理能力全解析:o3架构、链式思考与2025年8月发布
前端·后端
海风极客8 分钟前
Go内存逃逸分析,真的很神奇吗?
后端·面试
寻月隐君24 分钟前
Rust 泛型 Trait:关联类型与泛型参数的核心区别
后端·rust·github
泥泞开出花朵25 分钟前
LRU缓存淘汰算法的详细介绍与具体实现
java·数据结构·后端·算法·缓存
子洋32 分钟前
快速目录跳转工具 zoxide 使用指南
前端·后端·shell
用户5965906181341 小时前
在C# web api net core 开发中,对于Get 和 Post 的传值方式进行系统性的介绍
后端
凹凸曼说我是怪兽y1 小时前
python后端之DRF框架(上篇)
开发语言·后端·python
Victor3561 小时前
MySQL(173)MySQL中的存储过程和函数有什么区别?
后端