带有链接 属性 数组的 Swagger 注释

Question

我是 PHP Swagger 的新手，使用 Laravel 包 L5-Swagger 为我的 API 创建文档。现在我试图让一个模型包含另一个模型的数组，一个订单可以有多个 OrderItems。

不幸的是，我无法使链接正常工作。请参阅随附的屏幕截图。

我做错了什么？

这是我的订单模型：

/**
 * @SWG\Definition(
 *   required={"order_id","order_items"},
 *   type="object",
 *   @SWG\Xml(name="Order")
 * )
 */
class Order
{
    /**
     * @SWG\Property(example="O-789456123")
     * @var string
     */
    public $order_id;

    /**
     * @SWG\Property(type="array", items="$ref:OrderItem")
     * @var array
     */
    public $order_items = [];
}

这是我的 OrderItem 模型：

/**
 * @SWG\Definition(
 *   required={"sku","quantity", "price_including_tax"},
 *   type="object",
 *   @SWG\Xml(name="OrderItem")
 * )
 */
class OrderItem
{
    /**
     * @SWG\Property(example="SKU-123")
     * @var string
     */
    public $sku;

    /**
     * @SWG\Property(example=2)
     * @var integer
     */
    public $quantity;

    /**
     * @SWG\Property(example=199.75)
     * @var float
     */
    public $price_including_tax;
}

Answer 1

我觉得items="$ref:OrderItem"应该是@SWG\Items(ref="#/definitions/OrderItem")

Ps。检查中间格式（swagger.json）可以深入了解问题所在。