wolfpack-it/yii2-swagger

为 Yii2 框架提供的 Swagger 扩展。

v1.0.0 2020-04-22 07:31 UTC

This package is auto-updated.

Last update: 2024-09-22 18:02:53 UTC


README

本扩展为 Yii2 框架提供 Swagger 动作。

它是 light/yii2-swagger 的扩展。

安装

安装此扩展的首选方式是通过 composer

运行以下命令

$ composer require wolfpack-it/yii2-swagger

或者

"wolfpack-it/yii2-swagger": "^<latest version>"

将以下内容添加到您的 composer.json 文件的 require 部分。

如果需要 Swagger PHP 版本 3 或更高版本,则还必须安装

"zircote/swagger-php": "<latest version> as 2.0.0",

用法

通过在需要它的应用程序中扩展 \WolfpackIT\swagger\controllers\SwaggerController 来使用此包。通过覆盖 init 函数来设置扫描目录

public function init()
{
    $this->scanDirs = [
         \Yii::getAlias('@api/models'),
         \Yii::getAlias('@api/controllers'),
    ];
    parent::init;
}

您需要添加以下内容到应用程序参数中

    'swagger' => [
        'oAuthConfiguration' => [
            'baseUrl' => 'https://example.com/oauth/', // must end with a / (forward slash)
            'securityScheme' => 'exampleSecurity', // will be used to auto login
            'username' => 'info@example.nl', // will be used to auto login
            'password' => 'example', // will be used to auto login
            'clientId' => 'example-client', // will be used to auto login
            'clientSecret' => 'example', // will be used to auto login
        ]
    ]

建议只在应用程序不在生产环境中时使用自动登录功能!

如果您需要更细粒度的控制,请查看 \WolfpackIT\swagger\controllers\SwaggerController 中动作的配置。

其余的文档可以在 light/yii2-swagger 中找到。

鸣谢

许可证

MIT 许可证(MIT)。有关更多信息,请参阅 LICENSE