土曜日に複数のサンプルアイテムを追加するには

Question

スワッガーでこれを行う方法のヘルプが必要です。私はLineItemsにプロパティ上のLineItemとLineItem2を追加したい

@SWG\Property(property="LineItems", type="array", @SWG\Items(ref="#/definitions/LineItem")) 

@SWG\Definition(
    definition="LineItem", 
    required={"Description","Quantity","UnitAmount"}, 
    @SWG\Property(property="Description", type="string", example="Item 1"), 
    @SWG\Property(property="Quantity", type="integer", example=100), 
    @SWG\Property(property="UnitAmount", type="float", example=11) 
) 

@SWG\Definition(
    definition="LineItem2", 
    required={"Description","Quantity","UnitAmount"}, 
    @SWG\Property(property="Description", type="string", example="Item 2"), 
    @SWG\Property(property="Quantity", type="integer", example=10), 
    @SWG\Property(property="UnitAmount", type="float", example=21) 
) 

、私は出力が闊歩UIで複数の項目を持つ配列の例を表示するには、この

"LineItems": [ 
     { 
      "Description": "Item 1", 
      "Quantity": 100, 
      "UnitAmount": 11, 
     }, 
     { 
      "Description": "Item 2", 
      "Quantity": 100, 
      "UnitAmount": 22, 
     } 
     ] 

Answer 1

ようにする必要がありたい、あなたはアレイレベルを必要としますexample、例えば：

ある

LineItems: 
    type: array 
    items: 
    $ref: '#/definitions/LineItem' 

    # Multi-item example 
    example: 
    - Description: Item 1 
     Quantity: 100 
     UnitAmount: 11 
    - Description: Item 2 
     Quantity: 100 
     UnitAmount: 22 

は、アレイ項目の単一の定義（LineItem）があり、マルチアイテムの例では、使用して定義されていますキーワードは配列レベルにあります。

この闊歩-PHPのバージョンは次のようになります。それは完璧に動作

* @SWG\Property(
* property="LineItems", 
* type="array", 
* @SWG\Items(ref="#/definitions/LineItem"), 
* example = { 
*  {"Description": "Item 1", "Quantity": 100, "UnitAmount": 11}, 
*  {"Description": "Item 2", "Quantity": 100, "UnitAmount": 22} 
* } 
*)