latrell/swagger

Laravel 5 的 Swagger

安装次数: 61,700

依赖者: 0

建议者: 0

安全: 0

星星: 41

关注者: 2

分支: 19

语言:HTML

1.0.2 2018-03-16 03:15 UTC

This package is not auto-updated.

Last update: 2024-09-14 16:29:20 UTC


README

对于 Laravel 4,请使用 0.3 分支

Laravel 5 的 Swagger

此包将 swagger-phpswagger-ui 结合成一个对 Laravel 友好的包。

当您以调试模式运行应用程序时,Swagger 将扫描您的 Laravel 应用程序文件夹,生成 swagger json 文件并将它们存放到 docs-dir 文件夹(默认为 "docs")中。然后文件由 swagger-ui 在 api-docs 目录下提供。

安装

composer require latrell/swagger dev-master

使用 composer update 更新包或使用 composer install 安装。

使用方法

要使用 Swagger 服务提供器,您必须在引导 Laravel 应用程序时注册提供器。实际上有两种方法可以做到这一点。

config/app.php 中找到 providers 键并注册 Swagger 服务提供器。

    'providers' => [
        // ...
        'Latrell\Swagger\SwaggerServiceProvider',
    ]

运行 php artisan vendor:publish 将 swagger-ui 推送到您的公共文件夹并发布配置文件。

配置文件 config/latrell-swagger.php 是您与 Swagger 交互的主要方式。

示例