This commit is contained in:
wangjinlei
2022-04-06 18:02:49 +08:00
parent e34f87de36
commit c1885928ff
262 changed files with 18633 additions and 0 deletions

79
vendor/hg/apidoc/README.md vendored Normal file
View File

@@ -0,0 +1,79 @@
<p align="center">
<img width="120" src="https://apidoc.demo.hg-code.com/images/logo.png">
</p>
<h1 align="center">
ThinkPHP ApiDoc
</h1>
<div align="center">
基于ThinkPHP 根据注释自动生成API接口文档
</div>
<div align="center" style="margin-top:10px;margin-bottom:50px;">
<a href="https://packagist.org/packages/hg/apidoc"><img src="https://img.shields.io/packagist/v/hg/apidoc"></a>
<a href="https://packagist.org/packages/hg/apidoc"><img src="https://img.shields.io/packagist/dt/hg/apidoc"></a>
<a href="https://packagist.org/packages/hg/apidoc"><img src="https://img.shields.io/packagist/l/hg/apidoc"></a>
<a href="https://github.com/HGthecode/thinkphp-apidoc"><img src="https://img.shields.io/github/issues/HGthecode/thinkphp-apidoc"></a>
<a href="https://github.com/HGthecode/thinkphp-apidoc"><img src="https://img.shields.io/github/forks/HGthecode/thinkphp-apidoc"></a>
</div>
## 🤷‍♀️ Apidoc是什么
如今前后端分离的开发模式以必不可少基于ThinkPHP可以很方便的作为后端Api的开发。可是一个Api开发过程中需要快速调试开发完成后需要给其它开发者对接这时一个详细的Api文档就显得特别重要。
大多数开发者可能都是通过各种工具配合来达到这一目的其各种工具的安装和配置也是繁琐。甚至还有通过word等文本工具手写api文档的这样的开发效率与可维护性是非常差的。
综合种种Api开发中的痛点我们专为ThinkPHP开发了Apidoc的扩展插件本插件可通过简单的注解即可生成Api文档及帮助开发者提高生产效率的在线调试、快速生成Crud、一键生成整个模块Api等涵盖Api开发方方面面。
## ✨特性
- 开箱即用无繁杂的配置、安装后按文档编写注释即可自动生成API文档。
- 在线调试:在线文档可直接调试,支持设置全局参数,接口调试省时省力。
- 轻松编写:支持公共注释定义、业务逻辑层、数据表字段的引用,几句注释即可完成。
- 安全高效:支持访问密码验证、应用/版本独立密码;支持文档缓存。
- 多应用/多版本可适应各种单应用、多应用、多版本的项目的Api管理。
- Markdown文档支持.md文件的文档展示。
- 快速生成Crud配置+模板即可快速生成Crud接口代码及数据表的创建大大提高工作效率。
- 控制器分组:更精细化的对控制器接口进行分组展示。
## 📌兼容
ThinkPHP 5.x
ThinkPHP 6.x
> 📢 2.6.0版本开始全面兼容TP5了啦~~~
## 📖使用文档
[ThinkPHP ApiDoc V2.x文档](https://hg-code.gitee.io/thinkphp-apidoc/)
## 🏆支持我们
如果本项目对您有所帮助请点个Star支持我们
- [Github](https://github.com/HGthecode/thinkphp-apidoc) -> <a href="https://github.com/HGthecode/thinkphp-apidoc" target="_blank">
<img height="22" src="https://img.shields.io/github/stars/HGthecode/thinkphp-apidoc?style=social" class="attachment-full size-full" alt="Star me on GitHub" data-recalc-dims="1" /></a>
- [Gitee](https://gitee.com/hg-code/thinkphp-apidoc) -> <a href="https://gitee.com/hg-code/thinkphp-apidoc/stargazers"><img src="https://gitee.com/hg-code/thinkphp-apidoc/badge/star.svg" alt="star"></a>
## 💡鸣谢
[ThinkPHP](http://www.thinkphp.cn/)
<a href="http://www.thinkphp.cn/" target="_blank">ThinkPHP</a>
<a href="https://github.com/doctrine/annotations" target="_blank">doctrine/annotations</a>
## 🔗链接
<a href="https://github.com/HGthecode/apidoc-ui" target="_blank">ApiDoc UI前端</a>
<a href="https://github.com/HGthecode/thinkphp-apidoc-demo" target="_blank">ApiDoc Demo 示例项目</a>