1. 程式人生 > >php 使用 swagger 自動生成 API 文件

php 使用 swagger 自動生成 API 文件

使用 swagger 自動生成 API 文件

使用 swagger 自動生成 API 文件,有需要的朋友可以參考下。

一、下載 swagger-ui 直接上傳伺服器

二、下載 swagger-php 根據文件進行安裝

三、PHP檔案添加註釋程式碼

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

/**

* @SWG/Resource (

* apiVersion = "版本號",

* basePath = "API地址",

* resourcePath ="專案名稱",

* @SWG/Api (

* path = "API檔名",

* description = "功能描述",

* @SWG/Operation (

* method="POST", summary="操作描述", nickname = "顯示名",

* @SWG/Parameter (name="引數名", description="引數說明", required = true, paramType = "query", type="string"),

* @SWG/ResponseMessage (code=200, message="返回說明")

* )

* )

*)

*/

四、使用swager-php 生成JSON地址

php ../composer/vendor/zircote/swagger-php/swagger.phar /apifolder -o /docfolder

五、修改swagger-ui 預設資料地址

六、Done