ptx/lumen-yaml-swagger

Swagger文档,用PHP注释可读性差,维护性差,使用YAML格式
11 2
Install
composer require ptx/lumen-yaml-swagger
Latest Version:v1.0.2
PHP:>=7.1.3
License:MIT
Last Updated:Oct 3, 2020
Links: GitHub  ·  Packagist
Maintainer: putianxin

SwaggerLumenYaml

Swagger 2.0 for Lumen 5

SwaggerLume 进行封装。 使其支持YAML文档。

安装

composer require --dev ptx/lumenyaml-swagger

bootstrap/app.php

  • 去掉门面注释:
         $app->withFacades();
    
  • 添加配置加载:
         $app->configure('swagger-lume');
    
  • 注册服务:
        $app->register(\PtxDev\Swagger\SwaggerLumenServiceProvider::class);
    

app/Providers/AppServiceProviders.php

  • 添加默认@SWG/Info
      /**
       * @SWG\Swagger(
       *   @SWG\Info(
       *     title="My first swagger documented API",
       *     version="1.0.0"
       *   )
       * )
       */
    

其它使用见 SwaggerLume 文档