本文小编为大家详细介绍“PHP如何使用Swagger生成好看的API文档”，内容详细，步骤清晰，细节处理妥当，希望这篇“PHP如何使用Swagger生成好看的API文档”文章能帮助大家解决疑惑，下面跟着小编的思路慢慢深入，一起来学习新知识吧。s免费云主机域名wagger-php提供了命令行工具，所以可以全局安装，然后把工具的路径加到PATH里去。然后把zircote/swagger-php/bin 目录加到PATH里。这个东西本人用不到，就不研究了。a）、生成一个控制器： SwaggerControllerb）、添加一个方法： getJSON()有的文章里写 Swaggerscan()，但我这里报错，说找不到这个类。查了官方文档，要用 OpenApiGenerator::scan()。有可能是新版本做了修改。c）、设置路由api.php 或者 web.php都行，路径不同而已。本人选择api.php。所以访问路径要加个前缀：/api。d）、测试访问访问 http://localhost:8000/api/swagger/json 如果看到页面正常输出json，说明配置成功了。不然就按错误提示一项项去修改吧。GET方法这里面:in 表示该参数出现在哪里。 query的话就是用&拼在url后面; path 类似于 /api/data/search/{param} ; header就是包含在 request header里；cookie 自然是放在cookie里。这个版本里formData, body这些都没有了。required 看名字就知道 true是必填项，false是选填项。POST方法因为本人的前端代码post都是表单提交，所以这里的post方法要用@OARequestBody。@OAParameter是参数，是可以放到url上，但是post的表单提交，数据是不出现在url上的。@OAMediaType 这个: x-www-form-urlencoded 表单提交；application/json 提交json格式的数据；multipart/form-data 文件上传；这个是关联到一个已经定义好的schema上，省得使用相同数据的每个接口注释里都写一遍。这里也可以单独写：上面这样，有多少个参数就写多少个@OAProperty。这里的required是个数组，写在里面的都是必填项。解压后，把目录里的dist目录，复制到laravel的public目录下面，改名为swagger-ui。文件名随便取，不冲突就行。找开这个swagger-ui目录下的swagger-initializer.js，内容大概如下：主要是改 url这项。改成前面设的路由地址。这里是 “/api/swagger/json”。完成后访问 http://localhost:8000/swagger-ui/ 就能看到swagger形成的api文档了。读到这里，这篇“PHP如何使用Swagger生成好看的API文档”文章已经介绍完毕，想要掌握这篇文章的知识点还需要大家自己动手实践使用过才能领会，如果想了解更多相关内容的文章，欢迎关注百云主机行业资讯频道。
今天小编给大家分享一下如何利用Python自动生成PPT的相关知识点，内容详细，逻辑清晰，相信大部分人都还太了解这方面的知识，所以分享这篇文章给大家参考一下，希望大家阅读完这篇文章后有所收获，下面我们一起来了解一下吧。在日常工作中，PPT制作是常见的工作，如果…
免责声明：本站发布的图片视频文字，以转载和分享为主，文章观点不代表本站立场，本站不承担相关法律责任；如果涉及侵权请联系邮箱：360163164@qq.com举报，并提供相关证据，经查实将立刻删除涉嫌侵权内容。
微信扫一扫 
