laravel使用手札——Swagger

帕奇式

本例子使用Laravel 5.2版本

这里记录的是较为灵活的方案,不考虑使用swaggervel,具体使用参考一下步骤:

安装依赖swagger-php

composer require zircote/swagger-php

创建SwaggerController

php artisan make:controller SwaggerController

SwaggerController加上导出SwaggerJSON数据的处理

/**
 * @Swagger(
 *     schemes={"http"},
 *     basePath="/",
 *     consumes={"application/json"},
 *     tags={
 *         @SWG\Tag(
 *             name="API",
 *             description="API接口"
 *         )
 *     }
 * )
 *
 * @Info(
 *  title="API文档",
 *  version="0.1"
 * )
 *
 * @return mixed
 */
class SwaggerController extends Controller
{
    public function doc()
    {
        $swagger = \Swagger\scan(realpath(__DIR__.'/../../'));
        return response()->json($swagger);
    }
}

routes.php加上路由

Route::get('/swagger/doc', 'SwaggerController@doc');

接下来下载swagger-ui,将swagger-ui/dist目录内的文件拷贝于/public/swagger-ui目录下,可以尝试访问http://localhost/swagger-ui看看能否正常显示。

会发现文档地址还是例子的地址,可以修改public/swagger-ui/index.html文件下的默认地址

var url = window.location.search.match(/url=([^&]+)/);
if (url && url.length > 1) {
url = decodeURIComponent(url[1]);
} else {
url = "http://petstore.swagger.io/v2/swagger.json" //改成你的路由地址,如:/swagger/doc;
}

再刷新页面,慢慢享用!

阅读 8.5k

帕奇的手札
推敲、实验、搞破坏是每个孩子必经的阶段;)

设计和管理是毕生的课题👨‍💻

856 声望
66 粉丝
0 条评论

设计和管理是毕生的课题👨‍💻

856 声望
66 粉丝
文章目录
宣传栏