【问题标题】:How to Install Swagger-UI to Laravel 6 API for doumentation?如何将 Swagger-UI 安装到 Laravel 6 API 以获取文档?
【发布时间】:2019-10-18 04:10:31
【问题描述】:

在 laravel 6 中首次安装 Swagger。https://github.com/DarkaOnLine/L5-Swagger

composer require "darkaonline/l5-swagger"
php artisan vendor:publish --provider "L5Swagger\L5SwaggerServiceProvider"

关于生成命令

php artisan l5-swagger:generate

得到类似的错误:

php artisan l5-swagger:generate
Regenerating docs

   ErrorException  : Required @OA\Info() not found

  at D:\XMAPP\htdocs\minidmsapi\vendor\zircote\swagger-php\src\Logger.php:39
    35|         $this->log = function ($entry, $type) {
    36|             if ($entry instanceof Exception) {
    37|                 $entry = $entry->getMessage();
    38|             }
  > 39|             trigger_error($entry, $type);
    40|         };
    41|     }
    42| 
    43|     /**

  Exception trace:

  1   trigger_error("Required @OA\Info() not found")
      D:\XMAPP\htdocs\minidmsapi\vendor\zircote\swagger-php\src\Logger.php:39

  2   OpenApi\Logger::OpenApi\{closure}("Required @OA\Info() not found")
      D:\XMAPP\htdocs\minidmsapi\vendor\zircote\swagger-php\src\Logger.php:71

  Please use the argument -v to see more details.

请帮我生成 swagger 文档

【问题讨论】:

标签: laravel api laravel-6


【解决方案1】:

Required @OA\Info() 需要初始化您的 swagger 文档,然后使用适当的注释进行解析。注释仅在 /** DocBlocks 内解析。在这里你可以找到初始注释swagger-php#usage

【讨论】:

    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2020-01-28
    • 2014-02-22
    • 1970-01-01
    • 2016-12-30
    • 2022-07-05
    相关资源
    最近更新 更多