Swagger Laravel 5.5

Question

私はを使用してプロジェクトに統合しています。それを構成するための完全なステップを完了します。

は、ここで私は誰もこれから抜け出すに私を助けてくださいすることができます。このエラーに

$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

はそれがお役に立てば幸いです。