答案：Laravel中API版本控制可通过URL路径或请求头实现，推荐使用URL前缀如/api/v1区分版本，结合命名空间隔离控制器，也可用Accept头通过中间件解析版本，配合独立的Resource类管理响应结构，并在弃用时通过响应头提示，保持文档更新以确保平滑迁移。
在Laravel中实现API版本控制，主要是为了保证接口的向后兼容性，方便在不破坏旧客户端的前提下迭代新功能。常见的做法是通过URL路径或请求头来区分不同版本的API。以下是几种实用且清晰的实现方式。
使用URL路径进行版本控制
这是最常见、最直观的方式。将版本号直接放在API路由的URL中，比如 /api/v1/users 和 /api/v2/users，分别指向不同的逻辑处理。
在Laravel中，可以通过路由文件分组来实现：
// routes/api.php
// v1 版本
Route::prefix('v1')->group(function () {
Route::get('users', [V1\UserController::class, 'index']);
Route::post('users', [V1\UserController::class, 'store']);
});
// v2 版本
Route::prefix('v2')->group(function () {
Route::get('users', [V2\UserController::class, 'index']);
Route::post('users', [V2\UserController::class, 'store']);
});
同时，建议将不同版本的控制器放在独立的命名空间下，如 App\Http\Controllers\Api\V1 和 App\Http\Controllers\Api\V2，便于维护和隔离逻辑。
通过请求头区分API版本
部分项目希望保持URL简洁，会选择使用HTTP请求头（如 Accept 或自定义头）来指定API版本。
例如，客户端发送请求时设置：
Accept: application/vnd.myapp.v1+json
在Laravel中，可通过中间件解析请求头，并路由到对应版本的控制器：
// 创建中间件：php artisan make:middleware ApiVersion
class ApiVersion
{
public function handle($request, \Closure $next)
{
$version = 'v1'; // 默认版本
if ($request->headers->has('Accept')) {
$accept = $request->header('Accept');
if (strpos($accept, 'v2') !== false) {
$version = 'v2';
}
}
$request->route()->setParameter('version', $version);
return $next($request);
}
}
然后在路由中根据参数动态调用控制器，或结合服务容器绑定版本实例。
资源返回结构的版本管理
除了路由控制，数据格式也可能随版本变化。建议为不同版本的API使用独立的资源类（Resource）：
// v1 资源
class V1\UserResource extends JsonResource { ... }
// v2 资源（可能字段更多或结构不同）
class V2\UserResource extends JsonResource { ... }
在对应版本的控制器中返回各自的Resource，确保输出一致性和可维护性。
版本弃用与文档说明
当某个版本即将停用时，可在响应头中添加警告信息：
return response()->json($data)->withHeaders([
'X-API-WARNING' => 'Version v1 is deprecated. Please upgrade to v2.'
]);
配合API文档（如Swagger/OpenAPI）明确标注各版本状态，帮助开发者平滑迁移。
基本上就这些。Laravel本身不限定版本控制的具体方式，关键是结构清晰、易于维护。推荐优先使用URL路径方式，简单明了，适合大多数项目。如果追求更高级的语义化，再考虑请求头方案。不复杂但容易忽略的是长期维护多个版本带来的成本，建议定期清理过时版本。
