deepinglab/laravel7-apidoc-generator

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


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。