Swagger Laravel 5.5

Question

내 프로젝트에 swagger를 통합하기 위해 "darkaonline/l5-swagger": "^5.5",을 사용하고 있습니다. 구성하기위한 전체 단계를 완료하십시오.

는 여기에 내가 사람이 벗어나 려 저를 도와 주실 수있는이 오류를

$ref "#/definitions/Client" not found for @SWG\Items() in \App\Http\Controllers\Api\ClientApiController->index()있어 제 기능

/** 
* @SWG\Get(
* path="/clients", 
* summary="List clients", 
* operationId="listClients", 
* tags={"client"}, 
* @SWG\Response(
*  response=200, 
*  description="A list of clients", 
*  @SWG\Schema(type="array", @SWG\Items(ref="#/definitions/Client")) 
* ), 
* @SWG\Response(
*  response="default", 
*  description="an ""unexpected"" error" 
* ) 
*) 
*/ 
public function index() 
{ 
    $clients = Client::scope() 
     ->orderBy('created_at', 'desc') 
     ->withTrashed(); 

    if ($email = Input::get('email')) { 
     $clients = $clients->whereHas('contacts', function ($query) use ($email) { 
      $query->where('email', $email); 
     }); 
    } elseif ($idNumber = Input::get('id_number')) { 
     $clients = $clients->whereIdNumber($idNumber); 
    } 

    return $this->listResponse($clients); 
} 

입니다. Advanc에 감사드립니다.

Answer 1

모델을 조회 할 참조를 정의해야합니다.

/* 
|-------------------------------------------------- 
| MODEL DEFINITIONS - (Example) - New%model% 
|-------------------------------------------------- 
| /** 
| * @SWG\Definition(required={"name"}, definition="New%model%") 
| * 
| class Genre extends Eloquent 
| { 
|  /** 
|  * @SWG\Property(example="Electronic") 
|  * 
|  public $name; 
*/ 

이것은 모델에서 선언하는 방법이며 직접 정의 할 수도 있습니다.

https://github.com/zircote/swagger-php/tree/master/Examples/petstore.swagger.io/models

는 희망이 도움이 :

여기 당신은 더 많은 예제가 있습니다.