在 Url 的 Query 中传递 Array 的各种姿势

RFC 定义

RFC 3986 - Uniform Resource Identifier (URI): Generic Syntax

Network Working Group T. Berners-Lee Request for Comments: 3986 W3C/MIT STD: 66 R. Fielding Updates: 1738 Day Software Obsoletes: 2732, 2396, 1808 L. Masinter Category: Standards Track Adobe Systems January 2005 Uniform Resource Identifier (URI): Generic Syntax Status of This Memo This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements.

https://tools.ietf.org/html/rfc3986#section-3.4

'foo[]=1&foo[]=2&foo[]=3'
'foo[0]=1&foo[1]=2&foo[3]=3'
'foo=1,2,3'
'foo=1&foo=2&foo=3'
'foo=1|2|3'

在各语言中，如何约定 Array 的传递方式

Python

python/cpython

The Python programming language. Contribute to python/cpython development by creating an account on GitHub.

https://github.com/python/cpython/blob/3.9/Lib/urllib/parse.py

>>> from urllib.parse import urlencode
>>> query_data = {"foo":[1,2,3]}
>>> urlencode(query_data)
'foo=%5B1%2C+2%2C+3%5D'
>>> urlencode(query_data,True)
'foo=1&foo=2&foo=3'

>>> from urllib.parse import parse_qs
>>> parse_qs('foo=%5B1%2C+2%2C+3%5D')
{'foo': ['[1, 2, 3]']}
>>> parse_qs('foo=1&foo=2')
{'foo': ['1', '2']}

Node

Query string | Node.js v16.0.0 Documentation

Source Code: lib/querystring.js The querystring.decode() function is an alias for querystring.parse(). The querystring.encode() function is an alias for querystring.stringify(). The querystring.escape() method performs URL percent-encoding on the given str in a manner that is optimized for the specific requirements of URL query strings.

https://nodejs.org/api/querystring.html

> const querystring = require('querystring');
undefined
> querystring.decode("foo=1&foo=2")
[Object: null prototype] { foo: [ '1', '2' ] }
> querystring.encode({ foo: [ '1', '2' ] })
'foo=1&foo=2'

Golang

url - The Go Programming Language

func PathEscape(sstring) string PathEscape escapes the string so it can be safely placed inside a URL path segment, replacing special characters (including /) with %XX sequences as needed. PathUnescape does the inverse transformation of PathEscape, converting each 3-byte encoded substring of the form "%AB" into the hex-decoded byte 0xAB.

https://golang.org/pkg/net/url/#Values

gore version 0.5.1  :help for help
gore> :import net/url
gore> m, _ := url.ParseQuery(`foo=1&foo=1`)
url.Values{
  "foo": []string{
    "1",
    "1",
  },
}

结论