weburnit/swaggeravel

此包允许您:使用 Swagger PHP 生成 RESTful API 文档。

1.0 2017-07-12 12:07 UTC

This package is auto-updated.

Last update: 2024-08-29 04:31:24 UTC


README

Software License

此包是 Swagger-php 的包装,使其易于与 Lumen/Larvarel 集成。

用法

安装

通过 Composer

在您的 composer.json 中添加新包的信息

    "repositories": [
        {
          "type": "vcs",
          "url": "git@gitlab.lzd.co:operations/laraswagger.git",
          "name": "lazada/database-minifier"
        }
    ],
    "require": {
        "lazada/laraswagger": ">=1.0.0"
    }

Composer 安装完成后,注册服务提供者

  • Lumen 应用程序
$app->register(Swagger\LaraSwagger\Providers\LumeSwaggerServiceProvider::class);
  • Laravel 应用程序:目前不支持。

现在您可以与 LaraSwagger 一同摇滚了

  • 运行 php artisan swagger:generate file_name [base_host]:以生成 Swagger API 文档。

  • 转到 /swagger/api-docs(默认路由配置)以查看 JSON 格式的 Swagger API 文档

默认配置

<?php
return [
    'routes' => [
        'prefix' => 'swagger'
    ],
    'api' => [
        'directories' => [base_path('app')],
        'excludes' => [],
        'host' => null
    ]
];

自定义配置

为了更改默认配置,您可以将 config/lara-swagger.php 中的配置模板复制到您的应用程序的 config 目录中,并根据您的需要进行修改。有关更多信息,请参阅 Lumen 文档中的 配置文件 部分。

测试

./vendor/phpunit/phpunit/phpunit

./build 中查看测试结果