转载

TP5集成Swagger编写API文档(三)

上一篇讲解了如是使用YAML语法编写api说明文档

文档编写好之后,是要给开发人员看的,尤其是前端开发人员

发布文档

为当前创建虚拟目录(当然也不可以不创建,放在www目录下即可),然后修改 hosts 文件

<VirtualHost _default_:80>
DocumentRoot "D:/phpStudy/PHPTutorial/WWW/tpswagger/public"
ServerName simple.cn
ServerAlias malladmin.alima.cn
  <Directory "D:/phpStudy/PHPTutorial/WWW/tpswagger/public">
    Options -Indexes -FollowSymLinks +ExecCGI
    AllowOverride All
    Order allow,deny
    Allow from all
    Require all granted
  </Directory>
</VirtualHost>

在项目的public 目录下,新建一个文件 swagger,然后回到 swagger editor 的在线编辑界面,按如下操作到处json文件

TP5集成Swagger编写API文档(三)

将导出的json文件拷贝到上卖弄的swagger 目录下

打开swagger-ui 目录下的 index.html,修改 url 属性的路径为导出的swagger.json

TP5集成Swagger编写API文档(三)

在浏览器中输入如下地址,访问这个index.html 文档

http://simple.cn/swagger-ui/index.html

下面是不完全截图

TP5集成Swagger编写API文档(三)

以一种非常友好的方式展示了所有的api,展开api可以看到详细信息,还可以测试api

原文  https://blog.csdn.net/mynewdays/article/details/89066592
正文到此结束
Loading...