weifashi/think-apidoc

ThinkPHP API文档自动生成

维护者

详细信息

gitee.com/weifashi/think-apidoc.git

安装: 10

依赖者: 0

建议者: 0

安全: 0

类型:think-extend

dev-master 2022-11-28 13:18 UTC

This package is not auto-updated.

Last update: 2024-10-01 20:37:58 UTC


README

ThinkPHP ApiDoc

基于 ThinkPHP 的API接口开发工具

🤷‍♀️ Apidoc是什么?

如今,前后端分离的开发模式已成为必需,基于ThinkPHP可以方便地进行Api接口开发。但是,在Api开发过程中,需要快速调试,开发完成后需要其他开发者对接等,这时一个功能全面的Api文档工具就变得尤为重要。

大多数开发者可能都是通过各种工具配合来达到这一目的,这些工具的安装和配置也很繁琐。甚至还有通过word等文本工具手写api文档的,这样的开发效率与可维护性非常差。

针对Api开发中的各种痛点,我们专门为ThinkPHP开发了Apidoc扩展,本插件可通过简单的注解生成Api文档,并帮助开发者提高生产效率,如在线调试、快速生成Crud、一键生成整个模块Api等,涵盖了Api开发的各个方面。

✨特性

  • 开箱即用:无需繁琐的配置,安装后按文档编写注释即可自动生成API文档。
  • 在线调试:在线文档可直接调试,支持全局参数、Mock调试数据、事件执行,接口调试省时省力。
  • 轻松使用:支持公共注释定义、业务逻辑层、数据表字段等引用,几句注释即可完成。
  • 安全高效:支持访问密码验证、应用/版本独立密码;支持文档缓存。
  • 多应用/多版本:可适应各种单应用、多应用、多版本项目的Api管理。
  • Markdown文档:支持.md文件的文档展示。
  • 控制器分组:支持控制器多级分组,更精细化管理接口目录。
  • 多语言:可结合TP多语言能力,实现接口文档的语言切换。

📌兼容

ThinkPHP 5.1

ThinkPHP 6.x

📖使用文档

ThinkPHP ApiDoc V3.x文档

🏆支持我们

如果本项目对您有所帮助,请点个Star支持我们

💡鸣谢

ThinkPHP

doctrine/annotations

🔗链接

ApiDoc UI

ApiDoc Demo