Laravel怎么使用Dingo API_Laravel构建标准化RESTful API【插件】-Laravel

不推荐在新项目中使用 Dingo API，因其自2021年起已停止维护且不兼容新版Laravel和PHP；Laravel原生API支持完善，替代方案如Sanctum、JsonResource等更现代可靠。

为什么现在不推荐在新项目中用 Dingo API

Dingo API 曾经是 Laravel 社区最流行的 RESTful API 扩展包，但它早在 2021 年就停止维护（dingo/api 最后一次发布是 v3.0.0-alpha5），官方 GitHub 仓库已归档。Laravel 自 5.5 起原生强化了 API 支持（如 Route::middleware('api')、ResponseFactory 的 JSON 默认行为、API 资源类 JsonResource），8.x+ 更内置了 RateLimiter、Sanctum 和 Passport 等完整认证方案。

继续用 Dingo 会遇到这些实际问题：

• composer require dingo/api 在 Laravel 9/10 下大概率报依赖冲突（它锁死 illuminate/*: ^5.5|^6.0|^7.0|^8.0）
• 无法兼容 PHP 8.2+ 的严格类型检查（比如 AbstractProvider::register() 返回类型缺失）
• 文档过时，Stack Overflow 上多数答案对应 Laravel 5.x，API_PREFIX、API_VERSION 这些配置项在新版 Laravel 中早已被更灵活的路由分组替代

用原生 Laravel 实现 Dingo 的核心功能

Dingo 最常被依赖的几个能力：版本化路由、响应格式自动协商、异常统一 JSON 化——其实几行原生代码就能覆盖：

• 版本化路由：不用 apiVersion()，直接用路由前缀 + 中间件分组：

  Route::prefix('api/v1')->middleware('api')->group(function () {
      Route::get('/users', [UserController::class, 'index']);
  });

• 响应自动 JSON 化：Laravel 默认 api 中间件已启用 StartSession 和 ThrottleRequests，返回数组或模型会自动转为 JSON（无需 response()->json() 显式调用）
• 异常 JSON 化：修改 app/Exceptions/Handler.php 的 render() 方法：

  if ($request->is('api/*') && $exception instanceof \Exception) {
      return response()->json(['message' => $exception->getMessage()], 500);
  }

替代 Dingo 的现代方案选型建议

如果确实需要 Dingo 那类“开箱即用的 API 框架感”，优先考虑这些仍在活跃维护的方案：