swagger是java的一个接口调试工具,phper模仿他写了php-swagger
- github:https://github.com/zircote/swagger-php
- composer安装
composer require zircote/swagger-php
我用的tp5.0,打开项目主目录, 找到可执行文件openapi,也可以在Examples中找到例子,照着写就可以了
- 生成yaml指令
- 我在主目录的docs-dev中写编译前的注释文件,在public/docs中存放编译后的yaml文件
php ./vendor/zircote/bin/openapi ./docs-dev/ -o ./public/docs
- 使用swagger-ui
github:https://github.com/swagger-api/swagger-ui
可以通过npm导入模块,我直接用的github克隆下来使用
cd public git clone https://github.com/swagger-api/swagger-ui
克隆完成后,找到index.html,配置yaml文件路径
在42行配置好yaml文件路径即可
然后输入自己的测试服务器配置好的网址就可以访问了,例如我的服务器
swagger可以像 postman一样直接调试哦,非常方便