在laravel 5.6 中如何使用swagger

在laravel 5.6 中使用swagger

写本篇文章时，本人laravel版本为5.6.28

安装

composer require darkaonline/l5-swaggerUsing version ^5.6 for darkaonline/l5-swagger...  - Installing swagger-api/swagger-ui (v3.17.4)  - Installing doctrine/annotations (v1.6.0)  - Installing zircote/swagger-php (2.0.13)  - Installing darkaonline/l5-swagger (5.6.5)...

运行

php artisan vendor:publish

选择L5SwaggerL5SwaggerServiceProvider这项
这时会添加两个文件

/config/l5-swagger.php/resources/views/vendor/l5-swagger/index.blade.php

配置

在app/Http/Controllers/Controller.php文件中class前添加注释

<?phpnamespace AppHttpControllers;use IlluminateFoundationBusDispatchesJobs;use IlluminateRoutingController as BaseController;use IlluminateFoundationValidationValidatesRequests;use IlluminateFoundationAuthAccessAuthorizesRequests;/** * @SWGSwagger( *   basePath="/calculate-rates", *   @SWGInfo( *     title="项目名称 API", *     version="1.0.0" *   ) * ) */class Controller extends BaseController{    use AuthorizesRequests, DispatchesJobs, ValidatesRequests;}

运行命令

php artisan l5-swagger:generate

打开你的项目网址http://localhost/api/documentation，你会看到swagger已经运行成功了，但是没有显示任何API文档。

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

27 查看详情

编写文档

拿http://localhost/home 示例:
在HomeController的index方法上面编写文档

/**     * @SWGGet(     *   path="/home",     *   summary="用户资料",     *   @SWGResponse(response=200, description="请求成功"),     *   @SWGResponse(response=401, description="用户验证失败"),     *   @SWGResponse(response=500, description="服务器错误")     * )     *     */    public function index()    {        return view('home');    }

再次运行命令

php artisan l5-swagger:generate

回到http://localhost/api/documentation中刷新，文档就已经出来了，应该是长这个样子