Swagger PHP-描述对象数组

我使用Laravel+Swagger PHP。在我的一个服务中，我处理如下参数：

$params = [
   'addressChild' => [
        'address' => ' ... ',
        'city' => ' ... ',
    ],
    'addressParent' => [
        'address' => ' ... ',
        'city' => ' ... ',
    ],
];

我正试图使用OpenApi 3在招摇注释中描述此模式：

/**
 * @OA\Post(
 *      path="/entity/{entity}/addresses",
 *      @OA\Response(
 *          response=200,
 *          @OA\JsonContent()
 *      ),
 *      @OA\RequestBody(
 *          description="Addresses to store",
 *          required=true,
 *          @OA\JsonContent(
 *              type="object",
 *              @OA\Property()
 *          ),
 *      ),
 * )
 *
 */
public function update(Request $request)
{  ... }

我尝试了很多东西，比如：

 @OA\JsonContent(
     type="object",
     @OA\Property(name="addressKid", ref="#/components/schemas/ParkingAddressRequest") // error
 ),

---

我的地址数据在

ref=“#/components/schemas/ParkingAddressRequest”

schema中有描述，如何将其设置为RequestBody中的数组？

如果我了解您的问题，您可以这样做

/**
 * @OA\Post(
 *      path="/entity/{entity}/addresses",
 *      @OA\Response(
 *          response=200,
 *          @OA\JsonContent()
 *      ),
 *      @OA\RequestBody(
 *          description="Addresses to store",
 *          required=true,
 *          @OA\JsonContent(
 *              type="array",
 *              @OA\Items(ref="#/components/schemas/ParkingAddressRequest")
 *          ),
 *      ),
 * )
 *
 */