php+swagger生成api文档

前言：在无尽的编写api文档的过程中反复发送粘贴会觉得很烦，以前一直觉得要优化但是觉得没有必要，后面项目多了接口给的也多，自然每次发送word文档觉得很麻烦，借此机会研究了一下swagger，虽说php是世界上最好的语言但是奈何还是java的生态强大。

https://www.cnblogs.com/jcydd/p/11455989.html
1.根据这个文章我是反复尝试，反复的错，但是后面发现是版本号的问题。因此在这里对这个错误踩坑备注一下

2.swagger要下载2.x版本，否则你是无法成功的，主干默认是最新的3.0已经是不叫swagger了叫做openapi很高大上

image.png

2. php依赖也是要对应的2.x版本不然也是不成功composer require zircote/swagger-php 2.x-dev

最后踩坑成功送上成功的截图

image.png