toanld/laravel-apidoc-generator

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

4.0.2 2019-11-25 21:07 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

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

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');

文档

请查看ReadTheDocs 上的文档。如果您是从 v3 迁移到 v4,别忘了查看迁移指南

许可协议

Laravel API 文档生成器是免费软件,许可协议为 MIT 协议。