首页  >  文章  >  php框架  >  thinkphp5集成Swagger-PHP(排坑)

thinkphp5集成Swagger-PHP(排坑)

藏色散人
藏色散人转载
2020-09-07 09:22:533667浏览

下面由thinkphp教程栏目给大家介绍thinkphp5集成Swagger-PHP(排坑),希望对需要的朋友有所帮助!

thinkphp5集成Swagger-PHP(排坑)

学习 Swagger 过程中发现网上大部份的资料都不是特别全,所以特别发文把自己的排坑历程写出来,希望能对大家有帮助。

1、安装swagger-php2.0

(注:我下载的是swagger-php2.0,本文针对swagger-php2.0)

composer require zircote/swagger-php: 2.0.*

2、下载swagger-ui

去swagger-ui官网下载静态页面,把静态页面放到thinkphp框架目录里,例如public目录。

https://swagger.io/tools/swagger-ui/

3、thinphp框架引入swagger-php,生成swagger.json文件

use Swagger\Annotations as SWG;
class Index
{
public function index()
{
$swagger=\Swagger\scan(__DIR__);
$res=$swagger->saveAs('./swagger.json');
}

4、文档注释部分

/**
* @SWG\Swagger(
* schemes={"http"},
* host="www.tp.com.cn/",
* basePath="/",
* @SWG\Info(
* title="API文档",
* version="1.0.0",
* )
* ),
*/

详细关于Swgger-php的使用说明请访问

https://www.kancloud.cn/chengguang/swagger-php#/catalog

以上是thinkphp5集成Swagger-PHP(排坑)的详细内容。更多信息请关注PHP中文网其他相关文章!

声明:
本文转载于:segmentfault.com。如有侵权,请联系admin@php.cn删除