laravel swagger gener 文件的指令

最終生成指令 : php artisan l5-swagger:generate

根據您的問題和搜索結果,我可以為您提供生成 Laravel Swagger 文檔的步驟:

安裝必要的包

首先,您需要安裝必要的包:

composer require zircote/swagger-php
composer require darkaonline/l5-swagger

配置 Swagger

安裝包後,您需要配置 Swagger:

php artisan vendor:publish --provider="L5Swagger\L5SwaggerServiceProvider"

這會生成一個 config/l5-swagger.php 的配置文件。您可以在這裡自定義 Swagger 的設置。

添加 Swagger 注釋

為您的 API 端點添加 Swagger 注釋:

/**
 * @OA\Get(
 *     path="/api/users",
 *     @OA\Response(response="200", description="Display a listing of users.")
 * )
 */
public function index()
{
    return User::all();
}

執行以下命令來生成 Swagger 文檔:

php artisan l5-swagger:generate