Swagger-PHP

swagger-php

官网传送门

安装

• 安装swagger-php sdk,我这里是composer

composer require zircote/swagger-php 

• 安装swagger-ui

git clone https://github.com/swagger-api/swagger-ui.git
cd swagger-ui
npm install

• 配置swagger-ui访问地址
• php输出接口文件命令

php vendor/zircote/swagger-php/bin/openapi ./app/Http/Controllers/Finance/ -o swagger-ui磁盘目录/swagger-ui/dist/

• 访问配置swagger的域名/dist/#/
• 可以明确看到中间的输入框,可以通过url的方式解析接口文件

安装讲解

• swagger-php 只能生成json或yaml格式的接口文件,需要通过swagger-ui前端框架进行展示
• 通常将swagger-ui 放到和项目入口文件所在文件目录, 这样就可以使用相同的域名进行访问接口, 这样就不用单独配置nginx了,
  其次, 可以将生成的接口文件放在项目里,防止跨域问题(只推荐在测试服务器使用)
• 如何引用将swagger-php的注解文件, CLI模式下,

php vendor/zircote/swagger-php/bin/openapi 注解文件.php 指定的注解文件 -o ..

参考文档:

Swagger-PHP Git 地址
Swagger-PHP v3.x
Swagger-PHP V1.x
Swagger-PHP v3.x