hahadu / laravel-apidoc-generator

从您的Laravel应用程序生成漂亮的API文档

v0.3.1 2023-03-20 07:10 UTC

This package is auto-updated.

Last update: 2024-09-21 07:09:49 UTC


README

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

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

安装

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

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

composer require hahadu/laravel-apidoc-generator

composer dump or composer update 

Laravel

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

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

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

Lumen

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

文档

php artisan apidoc:generate

请查看Beyond Code主页上的文档。

许可证

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