详解Laravel5.6通过路由进行API版本控制的简单方法

(编辑:jimmy 日期: 2025/7/8 浏览:2)

Laravel版本:5.6

API随着迭代,新版本往往需要继承老版本的功能,并对原有的功能修改和扩展,这时为了兼容各个版本的接口,就需要进行版本控制。

请求版本区分:

在请求的header中附带版本信息,如app-version:1.0.1

laravel这边的获取方法:

Request::header('app-version');

文件路径:

1.0.1版本的UserController,文件路径就是
app/Http/Controllers/Api/v1d0d1/UserController.php

1.0.2版本,就是
app/Http/Controllers/Api/v1d0d2/UserController.php

注意1.0.2版本如果需要使用1.0.1原有的功能,需要继承原有的类

use App\Http\Controllers\Api\UserController as UserCtrl;
class UserController extends UserCtrl
{
  ...
}

版本控制

版本解析方法:

function getRouteContoller($controllerName)
{
  $base_path = 'App\Http\Controllers\Api\\';
  //无版本
  $app_version = Request::header('app-version');
  if (!$app_version) return $controllerName;
  //当前版本
  $version_path = 'v' . str_replace('.', 'd', $app_version) . '\\';
  $controllerPath = $base_path . $version_path . $controllerName;
  if (class_exists($controllerPath)) {
    return $version_path . $controllerName;
  }
  //往期版本
  $versionNumbers = intval(str_replace('.', '', $app_version));
  for ($i = $versionNumbers - 1; $i > 0; $i--) {
    $version_path = 'v' . implode('d', str_split($i)) . '\\';
    $controllerPath = $base_path . $version_path . $controllerName;
    if (class_exists($controllerPath)) {
      return $version_path . $controllerName;
    }
  }
  return $controllerName;
}

注:该方法会将1.0.2版本解析为v1d0d2,并判断对应类是否存在,如果存在则直接返回类的路径;不存在则向下寻找1.0.1版本类是否存在,直到找到存在的类返回。

路由文件

Route::post('login', getRouteContoller('UserController').'login');

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。

一句话新闻

一文看懂荣耀MagicBook Pro 16
荣耀猎人回归!七大亮点看懂不只是轻薄本,更是游戏本的MagicBook Pro 16.
人们对于笔记本电脑有一个固有印象:要么轻薄但性能一般,要么性能强劲但笨重臃肿。然而,今年荣耀新推出的MagicBook Pro 16刷新了人们的认知——发布会上,荣耀宣布猎人游戏本正式回归,称其继承了荣耀 HUNTER 基因,并自信地为其打出“轻薄本,更是游戏本”的口号。
众所周知,寻求轻薄本的用户普遍更看重便携性、外观造型、静谧性和打字办公等用机体验,而寻求游戏本的用户则普遍更看重硬件配置、性能释放等硬核指标。把两个看似难以相干的产品融合到一起,我们不禁对它产生了强烈的好奇:作为代表荣耀猎人游戏本的跨界新物种,它究竟做了哪些平衡以兼顾不同人群的各类需求呢?