api-platform.com - API 平台中的 OpenApi 上下文(用例 : anyOf)

Question

好吧，我对 the OpenAPiI V3 docs 中引用的 anyOf 的使用有点迷茫。在 api 平台中。

现在，根据 api platform我们可以按如下方式传递 openapi 上下文的文档

 * @ApiProperty(
 *     attributes={
 *         "openapi_context"={
 *             "type"="string",
 *             "enum"={"one", "two"},
 *             "example"="one"
 *         }
 *     }
 * )

不幸的是，我找不到有关 anyOf 使用的文档(或示例)。现在按照 previeus 示例，我希望它类似于

* @ApiProperty(
 *     attributes={
 *         "openapi_context"={
 *             "anyOf"={
 *                  "type"="string",
 *                  "type"="url",
 *                  "type"="base64"
 *             },
 *             "example"="one"
 *         }
 *     }
 * )

不幸的是，这行不通。

此外，还不清楚如何根据 anyOf 给出示例、描述等。

Answer 1

如果它对来到这里的人有用，则以下 PHP 8 属性有效:

#[ApiProperty(openapiContext: [
    'anyOf' => [
        ['type' => 'string'],
        ['type' => 'url'],
        ['type' => 'base64'],
    ]
])]