laravel 开发api(里的繁体字)

大家好，又见面了，我是你们的朋友全栈君。

本例子使用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;
}
然后就可以使用了。