laravel项目稳定系统如何保证兼容的同时进行持续迭代设计?

运行环境

laravel8+php7.4（提供纯api服务，对接web/安卓/ios）

情况说明

这是一个后台管理系统，有web端也有app端。在持续迭代设计上有两个痛点：

所有小版本迭代需要保持老版本的兼容（前端不需要强更）
有rbac存在，所以迭代需要继承老版本的权限，比如 order/list 接口后续不管怎么迭代已有该权限的管理员还是需要照样有该接口的权限

1.当前结构：

app
|----controller
|--------OrderControler.php
|--------UserController.php
|----service
|----model
...

auth表：

id route

1 order/list
rbac权限

id 管理员id auth_id

1 1 1

id	route
1	order/list

id	管理员id	auth_id
1	1	1

当前想法

目录结构：
- 最新版本的controller继承上一版本的controller，然后有变更的接口就复写action，有新增的就直接加action
- route区分 v1/order、v2/order版本接口来兼容老接口
```
app
|----controller
|--------V1
|------------OrderControler.php
|------------UserController.php
|--------V2
|------------OrderControler.php
|------------UserController.php
|----service
|----model
```
当前思路暴露的问题
- 每迭代一次路由就更换了一次（由v1/order变更成了v2/order），导致前端必须同步强更。如果只是web端其实影响不大，但是这个项目还有App端，尤其是小版本如此频繁的强更不切实际…
- auth表会增加历史路由，rbac权限表需要将已有v1权限的管理员将v2的权限也同步进去。甚至存在需要将已有v1权限的管理员将v3的权限同步进去（某些接口直接从v1迭代至v3的）
- 给管理员分配权限时，权限树会增加v1/v2/v3…很多历史结构，如何合理的保持干净结构
  
  id route
  
  1 v1/order/list
  
  2 v2/order/list

id	route
1	v1/order/list
2	v2/order/list

另外一种

所有接口识别query携带version参数，根据version进行分发到底执行哪个action，但是这里在哪个位置实现分发有点别扭。我是想再route层就进行识别分发，类似于这种在最顶层入口判断分发：

Route::get('order/list',function(Request $request){
    if($request->get('version')=='v3'){
        调用 v3/OrderController
    }else{
        调用 v1/OrderController
    }
});

但是在路由层写闭包写逻辑肯定是不好的，所以这种方案想了解下有没有什么基于路由全局判断自动分发的写法（或者说是在哪个位置节点能统一判断分发）。。。

最后

请问各位都是如何合理的设计这种系统持续迭代的？请不吝赐教真诚学习…[膜拜]

持续迭代设计架构思路方案讨论

yalng

课程读者 43 声望

暂无个人描述~

2 人点赞

以构建论坛项目 LaraBBS 为线索，展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。

从零开始带你一步步开发一个 Go 博客项目，让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。

推荐文章：

更多推荐...

博客

Git在项目中的那些实操(持续更新...) 22 / 3 |

博客

整理一些Linux相关知识，防止自己脑瘫 | 持续更新... 36 / 8 |

博客

消息中间件应用的常见问题与方案 28 / 4 |

博客

[踩了个坑] Laravel 访问https网址，url('/')竟然只返回 http？ 16 / 14 |

2022PHP面试题分享及归档（持续更新） 161 / 53 |

博客

强一致性的分布式事务几种模式对比（php有了新方案） 33 / 20 |

Dora__

课程读者 57 声望

最佳答案

这样可否

//  api.php
Route::get('/user/create', [\App\Http\Controllers\User\CreateController::class, '__invoke']);

// User/CreateController.php
<?php

namespace App\Http\Controllers\User;

use App\Http\Controllers\Controller;
use Illuminate\Http\Request;

class CreateController extends Controller
{
    public function __invoke(Request $request)
    {
        $version = $request->header('version', 'v1');
        if (method_exists($this, $version)) {
            return $this->$version($request);
        }
        throw new \Exception('Method not found', 404);
    }

    public function v1(Request $request)
    {
        return "Create User v1";
    }

    public function v2(Request $request)
    {
        return "Create User v2";
    }
}

1个月前评论

讨论数量: 21

springlee

课程读者 57 声望 / php @ zlj

:joy: 貌似每次迭代都新增版本这样并不好吧？可以不用设计成版本/+路由的方式，可以通过header传递版本号，通过版本号去判断去执行对应控制器。

1个月前评论

yalng （楼主）

这个通过版本号去判断执行分发在哪个位置实现比较好哇？我是想最好能统一全局识别判断，最好不要每个action或者每个controller都去实现

MArtian

@yalng 路由中间件

MArtian

@yalng 你可以给每个 version 都单独写一个路由文件，然后通过路由中间件决定跳转到哪个路由前缀

yalng （楼主）

@MArtian Route::get('order/list',[App\Controller\V1\OrderController::class,'list']) 中间件不能将这个路由定义转到 V2\OrderController里面去吧。我是想一个接口只定义声明一个route，但是需要由version参数决定分发到哪个controller，不知道我这个表达能不能明白

springlee （作者）

@yalng

Route::middleware('api_versioning')->group(function () {
    // 这里什么都不写，实际路由在中间件中动态加载
});

namespace App\Http\Middleware;

use Closure;

class ApiVersioningRouter
{
    public function handle($request, Closure $next)
    {
        $version = $request->header('API-Version', 'latest');
         require base_path('routes/api_defualt.php');
        // 根据版本加载不同的路由文件
        switch ($version) {
            case '1':
                require base_path('routes/api_v1.php');
                break;
            case '2':
                require base_path('routes/api_v2.php');
                break;
        }

        return $next($request);
    }
}

自己摸索一下，这个应该能满足

lovewei

109 声望

APP多版本控制，也不是迭代一个需求就增加一个版本的接口，业务链路发生较大改变才会出新版本接口，小版本都只是在原有的接口上横向扩展或兼容处理，多版本控制建议将版本号放在路由上，语义化强且接口独立性好，放在header中，还要做header处理分发路由，也比较麻烦，另外一般的App设计，都需要App传递客户端版本号，服务端版本放在header中与客户端版本有语义冲突。
如果权限控制不限制版本，在权限验证路由时，判断前缀是否为v*版本号开头，如果是直接替换为空就好了，这样权限基本不用动。

1个月前评论

Dora__

课程读者 57 声望

这样可否

//  api.php
Route::get('/user/create', [\App\Http\Controllers\User\CreateController::class, '__invoke']);

// User/CreateController.php
<?php

namespace App\Http\Controllers\User;

use App\Http\Controllers\Controller;
use Illuminate\Http\Request;

class CreateController extends Controller
{
    public function __invoke(Request $request)
    {
        $version = $request->header('version', 'v1');
        if (method_exists($this, $version)) {
            return $this->$version($request);
        }
        throw new \Exception('Method not found', 404);
    }

    public function v1(Request $request)
    {
        return "Create User v1";
    }

    public function v2(Request $request)
    {
        return "Create User v2";
    }
}

1个月前评论

伽蓝幻梦

课程读者 141 声望

不要变路由，可以加参数version 版本号，接口通过这个版本号判断走哪个方法，版本号存在且大于xx版本走新方法，旧的没有版本号字段就走旧的方法，因为有些用户是基本不升级app的，除非你弹窗强制升级，否则不能使用

1个月前评论

yalng （楼主）

我也想过这种所有接口识别 query 携带 version 参数，根据 version 进行分发到底执行哪个 action，但是这里在哪个位置实现分发调用哪个action有点纠结。我是想再 route 层就进行识别分发，有没有什么基于路由全局判断自动分发的写法啊（或者说是在哪个位置节点能统一判断分发）

伽蓝幻梦（作者）

@yalng 不是单次就修改几个接口么，难道你想把所有都拆成2个版本？我理解是需要变更哪个接口就在哪个接口的controller做判断就行了，没有变化的接口为什么要动

伽蓝幻梦（作者）

@yalng 或者你在route文件里获取版本号，再根据版本号分发给不同的路由组，路由组的路由都相同，但是controller方法对应的是不同的，但我没这么做过。。。一般加版本号在controller里调不同的service就解决了，逻辑差得多的新的也可以写新接口，app和前端调

yalng （楼主）

@伽蓝幻梦是的，你说的是对的，我的意思是不想每个版本都去写这个判断。v2版本发了3个接口那写3个，v3版本发了4个接口又写4个...我是想能不能不要每个版本都去写这个判断，全局性的自动的根据当前version去寻找ruote定义的那个接口，然后替换掉命名空间里的版本路径找对应版本的action，这样就不用每次迭代都要关心这个判断了。最好全局统一识别我是这个意思，但是我没有好的思路...

yalng （楼主）

@伽蓝幻梦恩恩，你这个在controller里调不同的service确实也可以解决。因为小版本的迭代有时候可能只是一些参数的校验不同，业务都一样。这时候就只是controller层的校验稍微不一样，Service的逻辑一样，所以这时候直接调不同controller入口比较好...大哥关于调不同controller有没有好的方案啊

伽蓝幻梦（作者）

@yalng

$ver = $_GET['ver'] ?? ''; 
if(empty($ver)){    
    Route::get('/index', [\App\Http\Controllers\IndexController::class, 'index']);   
}else{     
    Route::get('/index', [\App\Http\Controllers\IndexController::class, 'index_'.$ver]);  
}

先说好我没这么写过，但试了下应该也行。。。要避免ver参数客户端和前端冲突，或者不用get传，你看看别人有什么好的方案吧。

yalng （楼主）

@伽蓝幻梦哈哈哈哈，就是这个意思，就是不太优雅，感谢感谢

Smilephp

课程读者 110 声望

痛苦，只要迭代的久，那么可能会发现改一个逻辑，会修改N个版本的方法

1个月前评论

yalng （楼主）

确实，所以我想隔代版本就强制更新。v3时直接v1不让用必须更新，然后v4或者v5时清除v1的代码。想是这么想的，不知道后续执行会不会偷懒踩坑啥的，哈哈哈

dongjw321

28 声望

在controller方法里，根据版本做一些兼容，简单就直接controller里加版本控制，复杂的，新建一个method，然后根据版本在老的method里，return 到新的

2.controller里，建立方法 method,mthodV2,mthodV3, 然后改造app的调用方法，根据客户端的上报的version 自动调用当前的version或是比他小的version版本

file 如果是这种方法，如果一个BUG，是很久才发现，你会死的很难看。【除非你有足够的开发和测试人员】

1个月前评论

yalng （楼主）

感谢大佬分享，你这个method,mthodV2,mthodV3确实可以

dongjw321

28 声望

我们现在采用的是1，好处就是维护成本很小，坏处代码多了很多版本判断的逻辑

file

1个月前评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容，与人为善，比聪明更重要！

帮助

laravel项目稳定系统如何保证兼容的同时进行持续迭代设计?

运行环境

情况说明

当前想法

另外一种

最后

推荐文章：

社区赞助商

关于 LearnKu

资源推荐

服务提供商

其他信息

laravel项目稳定系统如何保证兼容的同时进行持续迭代设计?

运行环境

情况说明

当前想法

另外一种

最后

推荐文章：

社区赞助商

关于 LearnKu

资源推荐

服务提供商

其他信息

请登录