可通过路由前缀、请求头、子域名或命名空间实现Laravel API版本控制。1、使用Route::prefix('v1')隔离URL路径；2、通过Accept头如application/vnd.myapp.v1+json在中间件中解析版本；3、配置Nginx与Route::domain区分v1.api.example.com等子域；4、结合Route::namespace组织V1/V2控制器，提升结构清晰度与维护性。
如果您正在开发一个基于Laravel的API服务，并希望对不同版本的接口进行有效管理，以确保客户端升级时不影响旧有功能，则可以通过多种方式实现API版本控制。合理的版本控制策略有助于维护系统的稳定性和可扩展性。
本文运行环境：MacBook Pro，macOS Sonoma
一、使用路由前缀进行版本控制
通过在路由定义中添加版本号作为URL前缀，是最常见且易于理解的方式。这种方式将不同版本的API隔离到不同的URL路径下，便于管理和维护。
1、打开 routes/api.php 文件，使用 Route::prefix() 方法为路由设置版本前缀。
2、将API路由包裹在带有版本标识的组中，例如 v1 或 v2。
3、示例代码如下：
<?php
Route::prefix('v1')->group(function () {
Route::get('/users', [UserController::class, 'index']);
});
Route::prefix('v2')->group(function () {
Route::get('/users', [V2UserController::class, 'index']);
});
二、通过请求头识别API版本
利用HTTP请求头中的自定义字段（如 Accept 或自定义版本头）来决定调用哪个版本的控制器逻辑，可以保持URL的一致性，同时实现后端的版本分离。
1、客户端在请求时添加类似 Accept: application/vnd.myapp.v1+json 的头部信息。
2、在Laravel的中间件中解析该请求头，根据版本号动态绑定对应的控制器或服务类。
3、创建中间件处理版本判断逻辑：
php artisan make:middleware HandleApiVersion
4、在中间件中读取请求头并修改路由行为或注入特定服务实例。
三、基于域名的版本隔离
通过不同的子域来区分API版本，例如 v1.api.example.com 和 v2.api.example.com，适用于多团队协作或独立部署场景。
1、配置Web服务器（如Nginx）将不同子域指向相同应用的不同处理逻辑。
2、在Laravel的 RouteServiceProvider 中根据 host 判断加载对应版本的路由文件。
3、示例配置：
Route::domain('v1.api.example.com')->group(base_path('routes/api_v1.php'));
4、将各版本路由拆分至独立文件，提升可维护性。
四、结合控制器命名空间区分版本
当API版本较多时，可通过命名空间组织控制器，使结构更清晰，避免文件冲突。
1、创建目录结构如 App/Http/Controllers/V1 和 App/Http/Controllers/V2。
2、在路由组中使用 Route::namespace() 指定当前组的控制器命名空间。
3、示例代码：
Route::prefix('v1')
->namespace('App\Http\Controllers\V1')
->group(base_path('routes/api.php'));
4、确保每个版本的控制器继承自合适的基类并遵循统一接口规范。
