【发布时间】:2019-08-20 05:17:14
【问题描述】:
已经支持 Laravel 或 Cake PHP 等框架,但我有我的旧核心 PHP 项目,我需要在其中为其现有 API 实现 Swagger。请建议我,因为它的文档很难面对。
【问题讨论】:
标签: php api swagger swagger-codegen swagger-php
已经支持 Laravel 或 Cake PHP 等框架,但我有我的旧核心 PHP 项目,我需要在其中为其现有 API 实现 Swagger。请建议我,因为它的文档很难面对。
【问题讨论】:
标签: php api swagger swagger-codegen swagger-php
Swagger / OpenApi 不需要框架的支持。
它是一个 yaml 或 json 文件规范,用于记录您的 REST api。
您需要知道您的 api 是如何工作的,这不是一个自动过程。
我建议先手动编写yaml文件来描述一个api端点,然后通过swagger-ui查看文件。
一旦您稍微熟悉了规范,您就可以考虑 swagger-php,它也与框架无关。好处是文档更接近实现,这使得它更有可能在代码更改时得到更新。
【讨论】: