下面由thinkphp教程栏目给大家介绍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(排坑)的详细内容。