ThinkPHP6.0.16接口版本控制路由配置-ThinkPHP-PHP中文网

最稳妥、可维护性最强的方式是采用url路径前缀（如/api/v1/xxx）配合路由分组与显式命名；需按版本分组定义路由、隔离控制器命名空间、强制路由并清除缓存，同时提供v1兼容兜底。

thinkphp6.0.16接口版本控制路由配置

ThinkPHP6.0.16 中实现接口版本控制，最稳妥、可维护性最强的方式是采用 URL 路径前缀（如 /api/v1/xxx），配合路由分组与显式命名。它调试直观、日志清晰、客户端兼容友好，也符合你知识库中强调的“首选路径前缀”原则。

一、按版本划分路由分组

在应用路由文件（如 app/route/app.php）中，用 Route::group() 分别定义 v1、v2 等版本分组：

每个分组指定独立前缀（如 'api/v1'）、中间件（如鉴权、JSON响应统一处理）和专属配置
必须调用 ->option(['url_html_suffix' => '']) 关闭 .html 后缀，避免干扰 API 请求
内部所有路由路径为相对路径，无需重复写 v1/

示例：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

php
use think\facade\Route;

// v1 版本分组
Route::group('api/v1', function () {
  Route::get('user/info', 'api.v1.UserController@info')->name('api.v1.user.info');
  Route::post('order/create', 'api.v1.OrderController@create')->name('api.v1.order.create');
})->option(['url_html_suffix' => '']);

// v2 版本分组（字段结构变更、新增字段等）
Route::group('api/v2', function () {
  Route::get('user/info', 'api.v2.UserController@info')->name('api.v2.user.info'); // avatar 返回 CDN 全路径
  Route::post('order/create', 'api.v2.OrderController@create')->name('api.v2.order.create');
})->option(['url_html_suffix' => '']);

二、控制器与命名空间隔离

不同版本的接口逻辑应物理隔离，避免混杂：

创建对应目录：如 app/controller/api/v1/UserController.php 和 app/controller/api/v2/UserController.php
控制器类名可相同，但命名空间必须严格区分：app\controller\api\v1 与 app\controller\api\v2
这样能保证 v1 和 v2 的业务逻辑完全解耦，升级 v2 不影响 v1 运行