Swagger در لاراول

سواگر چیه هست ؟ یک ابزار قوی برای مدیریت، مستندسازی ( Documentation APIs ) و حتی تست API . . .

خب رای نصب سواگر کد اول اونو داخل پروژه لاراولمون اضافه میکنیم «:

composer require "darkaonline/l5-swagger"

بعد یک کنترل و روتو اون رو میسازیم و داخل کنترل قبل از تابع index این کدهارو اضافه میکنیم :

Route::resource('/main', \App\Http\Controllers\MainController::class);
php artisan make:controller MainController -r

 ...... 
     /**
     * * @OA\Info(title="Project", version="0.1")
     * @OA\Get(
     *     path="/main",
     *     @OA\Response(response="200", description="Display a listing of projects.")
     * )
     */
    /**
     * Display a listing of the resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        //
    }
.......

و بعد

php artisan l5-swagger:generate

حالا کافیه به آدرسapi/documentation بریم و لیست هارو ببینیم.