php - 使用 Swagger/OpenAPI 规范指定要作为 GET 参数发送的数组

Question

以下招摇定义：

swagger: '2.0'
host: example.com
paths:
  /theResource:
    get:
      parameters:
        - $ref: '#/parameters/fields'
parameters:
  fields:
    name: fields
    description: Fields to return
    in: query
    type: array
    collectionFormat: multi
    uniqueItems: true
    items:
      type: string
      enum:
        - column1
        - column2
        - column3

将生成以下 URL，而服务器只会收到fields等于column3.

http://example.com/theResource?fields=column1&fields=column2&fields=column3

如何更改它以使其在参数中发送一个数组？例如：

http://example.com/theResource?fields[]=column1&fields[]=column2&fields[]=column3

Answer 1

在 PHP 中，您可以使用http_build_query，它将为您构建正确的 URL 查询部分。

<?php

$query = http_build_query([
    'fields' => [
        'one', 'two', 'three'
    ],
]);

$url = "https://example.com/?".$query;

是的，fields[]语法应该可以解决问题。