git地址
packagist地址
swagger在线edit
composer require zircote/swagger-php
/**
* @SWG\Swagger(
* host="qs.com",
* consumes={"multipart/form-data"},
* produces={"application/json"},
* @SWG\Info(
* version="0.0.1",
* title="大黄专用",
* description="趣租乐管理系统接口"
* ),
* @SWG\Tag(
* name="User",
* description="用户操作",
* externalDocs={"description":"基础用户操作接口"}
* ),
*
* @SWG\Tag(
* name="MainPage",
* description="首页模块",
* ),
* )
*/
public function getJSON()
{
//扫描地址
$swagger = \Swagger\scan(app_path('Http/Controllers/'));
return response()->json($swagger, 200);
}
/**
* @SWG\Put(path="/swagger/my-data",
* tags={"User"},
* summary="测试get1",
* description="请求该接口需要先登录。",
* operationId="getMyData",
* produces={"application/json"},
* @SWG\Parameter(
* in="body",
* name="body",
* type="integer",
* description="拿数据的理由",
* required=true,
* schema={
* "$ref": "#/definitions/Pet"
* }
* ),
* @SWG\Response(response="200", description="操作成功")
* )
*/
/**
* @SWG\Definition(
* definition="Pet",
* @SWG\Property(
* example="1|2",
* property="code",
* type="integer",
* ),
* @SWG\Property(
* property="msg",
* type="string"
* ),
* @SWG\Property(
* property="info",
* type="object",
* example="{num1:1,num2:2}",
* )
* ),
*/
url 改成 getJson路由
新增 屏蔽右下角error
window.swaggerUi = new SwaggerUi({
validatorUrl: null,
});