无法在laravel上使用swagger生成文档

时间:2018-05-30 04:03:00

标签: laravel api swagger

我最近在我的项目中使用了招摇,我使用了来自DarkaOnLine的L5-swagger。我跟着安装步骤。安装后,我在控制器上添加此代码

/**
* @SWG\Swagger(
*   basePath="/users",
*   @SWG\Info(
*     title="List all available users",
*     version="1.0.0"
*   )
* )
*/

之后,我运行" php artisan l5-swagger:generate"在终端。但我得到了这个错误:

"未找到@OAS \ Info()"

2 个答案:

答案 0 :(得分:1)

我认为你必须将swagger-php的版本替换为2.0。在Github上的DarkaOnLine的SwaggerLume中提到了同样的错误。

见这里:https://github.com/DarkaOnLine/SwaggerLume/issues/51

答案 1 :(得分:0)

你需要

/**
 * @OA\Info(title="My First API", version="0.1")
*/

但是在这行代码之后,你会遇到一个新的错误。所以把 info 放在 class 的起始括号下面,在你需要的控制器上面,但是第二块代码,当然你需要为你的路由修改它。

/**
 * @OA\Get(
 *     path="/projects",
 *     @OA\Response(response="200", description="Display a listing of projects.")
 * )
 */