geidelguerra/laravel-apidoc-generator

从您的 Laravel 应用程序生成美观的 API 文档

4.8.2 2020-05-28 14:10 UTC

README

自动从现有的 Laravel/Lumen/Dingo 路由生成 API 文档。

php artisan apidoc:generate

Latest Stable VersionTotal Downloads License codecov.io Scrutinizer Code Quality Build Status StyleCI

安装

需要 PHP 7.2 和 Laravel/Lumen 5.7 或更高版本。

如果您的应用程序不符合这些要求,您可以查看 3.x 分支以获取旧版本。

composer require --dev mpociot/laravel-apidoc-generator

Laravel

通过运行以下命令发布配置文件

php artisan vendor:publish --provider="Mpociot\ApiDoc\ApiDocGeneratorServiceProvider" --tag=apidoc-config

这将创建一个位于您的 config 文件夹中的 apidoc.php 文件。

Lumen

  • 当使用 Lumen 时,您需要运行 composer require mpociot/laravel-apidoc-generator
  • 在您的 bootstrap/app.php 中注册服务提供者
$app->register(\Mpociot\ApiDoc\ApiDocGeneratorServiceProvider::class);
  • 将配置文件从 vendor/mpociot/laravel-apidoc-generator/config/apidoc.php 复制到您的项目中的 config/apidoc.php。然后将其添加到您的 bootstrap/app.php
$app->configure('apidoc');

文档

请参阅 Beyond Code 主页 中的文档。

许可证

Laravel API 文档生成器是免费软件,根据 MIT 许可证授权。