Swagger PHP 数组数组

Question

我正在尝试创建一个响应示例，该示例应该 return 一个像这样的数组：

[
  [
    "Shop Name",
    "53.7094190",
    "-1.9084720"
    ,1
  ]
]

为此，我使用此代码：

*   @OA\Response(
*     response= "default",
*     description="Success: Array of shops",
*     @OA\MediaType(
*       mediaType="text/plain",
*         @OA\Schema(
*           type = "array",
*           @OA\Items( type="array",
*              @OA\Items(type="string", default="'Bridge Balti','53.7094190','-1.9084720',1"),
*           ),
*         )
*     )
*   )

我在 swagger hub 中得到了这个：

[
  [
    "string"
  ]
]

Answer 1

如果你只是想在swagger中显示一个例子ui，那么你需要使用"example"参数。

@OA\Items(type="string",example="'Bridge Balti','53.7094190','-1.9084720',1")

Swagger PHP 数组数组

Swagger for PHP array of arrays

php

swagger

openapi

swagger-php