swagger-php的使用

一、安装swagger-php

1、git安装：git clone https://github.com/zircote/swagger-php.git

2、composer安装：composer require zircote/swagger-php

二、安装swagger-ui

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

三、生成接口文档（swagger.json）

1、通过客户端模式执行以下命令生成

php zircote\swagger-php\bin\openapi 需要生成接口文档的目录 -o 接口文档生成位置（swagger.json）

低版本的执行文件不是openapi而是swagger，将上面的openapi替换成swagger就可以了。

2、通过接口程序生成

$swagger = \Swagger\scan(需要生成接口文档的目录);

$res = $swagger->saveAs(接口文档生成位置‘swagger.json’);

四、swagger-ui获取swagger.json的数据

1、将swagger-ui\dist\swagger-initializer.js文件下的url参数改成swagger.json对应的路径

2、低版本直接在swagger-ui\dist\ndex.html文件下的url参数就可以了