1.安裝swagger。 ~~~bash composer require darkaonline/l5-swagger ~~~ 2.創建config/l5-swagger.php配置文件。 ~~~ php artisan vendor:publish --provider "L5Swagger\L5SwaggerServiceProvider" ~~~ 3.使用。 ``` php artisan l5-swagger:generate ``` 使用phpartisan l5-swagger:generate生成文檔，此時會在storage/api-docs,生成一個api-docs.json的文件，一會每次生成都會覆蓋此文件。如果需要開啟自動生成，可在配置文件或.env文件中設置`generate_always`參數為`true``。這個時候訪問你的項目域名+`[*/ api / documentation*](http://vrm-service-url/api/documentation)。你會看到。 4.相關注釋詳情。[鏈接](https://www.sdk.cn/details/9pPQD6wqK09L8ozvNy) ~~~ /** * @OA\OpenApi( * @OA\Server( * url="http://cs.laravel.com/api/v1", * description="后臺接口前綴" * ), * @OA\Info( * title="系統管理相關接口", * version="1.0.0", * description="描述", * termsOfService="http://example.com/terms/", * @OA\Contact( * name="宋博", * url="http://www.lvacms.cn", * email="997786358@qq.com" * ), * @OA\License( * name="Apache 2.0", * url="http://www.lvacms.cn" * ) * ) * ) */ /** *@OA\Tag(name="UnAuthorize", description="No user login required") */ /** * @OA\SecurityScheme( * type="apiKey", * description="全局添加API Token鑒權", * name="authorization", * in="header", * securityScheme="Authorization-Bearer" * ) */ /** * @OA\SecurityScheme( * type="apiKey", * description="全局添加key", * name="apikey", * in="header", * securityScheme="Authorization-key" * ) */ ~~~ ~~~ /** * @OA\Get( * path="/index", * operationId="getListOfUsers", * tags={"Admin"}, * description="接口描述", * security={{ "Authorization-Bearer":{},"Authorization-key":{} }}, * @OA\Parameter( * name="offset", * @OA\Schema( * type="integer", * format="int64" * ), * in="query", * description="offset", * example=0, * required=true, * ), * @OA\Parameter( * name="limit", * @OA\Schema( * type="integer", * format="int64" * ), * in="query", * description="offset", * example=10, * required=true, * ), * @OA\Response( * response=200, * description="success", * @OA\JsonContent(type="object", * @OA\Property(property="message", type="string"), * @OA\Property(property="data", type="array", * @OA\Items(type="object", * @OA\Property(property="id", type="integer"), * @OA\Property(property="name", type="string"), * @OA\Property(property="email", type="string",format="111",description="其他二外參數") * ), * ), * ), * ) * ) */ ~~~