【问题标题】:How to integrate Swagger for existing APIs in my Core PHP project?如何在我的 Core PHP 项目中为现有 API 集成 Swagger?
【发布时间】:2019-08-20 05:17:14
【问题描述】:

已经支持 Laravel 或 Cake PHP 等框架,但我有我的旧核心 PHP 项目,我需要在其中为其现有 API 实现 Swagger。请建议我,因为它的文档很难面对。

【问题讨论】:

    标签: php api swagger swagger-codegen swagger-php


    【解决方案1】:

    Swagger / OpenApi 不需要框架的支持。

    它是一个 yaml 或 json 文件规范,用于记录您的 REST api。

    您需要知道您的 api 是如何工作的,这不是一个自动过程。

    我建议先手动编写yaml文件来描述一个api端点,然后通过swagger-ui查看文件。

    一旦您稍微熟悉了规范,您就可以考虑 swagger-php,它也与框架无关。好处是文档更接近实现,这使得它更有可能在代码更改时得到更新。

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 2017-08-20
      • 2021-11-14
      • 2021-03-22
      • 2017-12-25
      • 2016-10-13
      • 1970-01-01
      • 2021-01-06
      • 2011-09-08
      相关资源
      最近更新 更多