targettech/laravel-api-doc-generator

自动从表单请求规则、控制器和路由生成 Laravel API 文档

dev-main 2022-09-15 13:15 UTC

This package is auto-updated.

Last update: 2024-09-15 17:50:46 UTC


README

无需编写注解即可自动为 Laravel 生成 API 文档。

要求

安装

您可以通过 composer 安装此包

composer require targettech/laravel-api-doc-generator --dev

您可以使用以下命令发布配置文件

php artisan vendor:publish --tag=request-docs-config

使用方法

/request-docs/ 上通过浏览器查看

或生成静态 HTML

php artisan lrd:generate

文档 HTML 生成在 docs/ 目录内。

设计模式

为了让此插件正常工作,您需要在控制器内部注入请求类,并遵循设计模式。此外,您还可以在控制器方法中使用 Markdown 格式编写额外的文档。

Design pattern

屏幕截图

生成的 API 文档

Preview

尝试 API

Preview

测试

./vendor/bin/phpunit

变更日志

  • 首次发布