本文转载自微信公众号「Gopher指北」,作者新世界杂货铺。转载本文请联系Gopher指北公众号。
URL中不能显示地包含空格这已经是一个共识,而空格以何种形式存在,在不同的标准中又不完全一致,以致于不同的语言也有了不同的实现。
rfc2396中明确表示空格应该被编码为%20。
而W3C的标准中却又说空格可以被替换为+或者%20。
老许当场懵逼,空格被替换为+,那+本身只能被编码。既然如此,为什么不直接对空格进行编码呢。当然这只是老许心中的疑惑,以前的背景我们已经无法追溯,已成的事实我们也无法改变。但,空格到底是被替换为+还是20%,+是否需要被编码都是现在的我们需要直面的问题。
Go常用的三种URL编码方式
作为Gopher最先关注的自然是Go语言本身的实现,因此我们首先了解一下Go中常用的三种URL编码方式的异同。
url.QueryEscape
- fmt.Println(url.QueryEscape(" +Gopher指北"))
- // 输出:+%2BGopher%E6%8C%87%E5%8C%97
使用url.QueryEscape编码时,空格被编码为+,而+本身被编码为%2B。
url.PathEscape
- fmt.Println(url.PathEscape(" +Gopher指北"))
- // 输出:%20+Gopher%E6%8C%87%E5%8C%97
使用url.PathEscape编码时,空格被编码为20%, 而+则未被编码。
url.Values
- var query = url.Values{}
- query.Set("hygz", " +Gopher指北")
- fmt.Println(query.Encode())
- // 输出:hygz=+%2BGopher%E6%8C%87%E5%8C%97
使用(Values).Encode方法编码时,空格被编码为+,而+本身被编码为%2B,进一步查看(Values).Encode方法的源码知其内部仍旧调用url.QueryEscape函数。而(Values).Encode方法和url.QueryEscape的区别在于前者仅编码query中的key和value,后者会对=、&均进行编码。
对我们开发者而言,这三种编码方式到底应该使用哪一种,请继续阅读后文相信你可以在后面的文章中找到答案。
不同语言中的实现
既然空格和+在Go中的URL编码方式有不同的实现,那在其他语言中是否也存在这样的情况呢,下面以PHP和JS为例。
PHP中的URL编码
urlencode
- echo urlencode(' +Gopher指北');
- // 输出:+%2BGopher%E6%8C%87%E5%8C%97
rawurlencode
- echo rawurlencode(" +Gopher指北");
- // 输出:%20%2BGopher%E6%8C%87%E5%8C%97
PHP的urlencode和Go的url.QueryEscape函数效果一致,而rawurlencode则将空格和+均进行编码。
JS中的URL编码
encodeURI
- encodeURI(' +Gopher指北')
- // 输出:%20+Gopher%E6%8C%87%E5%8C%97
encodeURIComponent
- encodeURIComponent(' +Gopher指北')
- // 输出:%20%2BGopher%E6%8C%87%E5%8C%97
JS的encodeURI和Go的url.PathEscape函数效果一致,而encodeURIComponent则将空格和+均进行编码。
我们应该怎么做
更推荐使用url.PathEscape函数编码
在前文中已经总结了Go、PHP和JS对+Gopher指北的编码操作,下面总结一下其对应的解码操作是否可行的二维表。
编码/解码 | url.QueryUnescape | url.PathUnescape | urldecode | rawurldecode | decodeURI | decodeURIComponent |
---|---|---|---|---|---|---|
url.QueryEscape | Y | N | Y | N | N | N |
url.PathEscape | N | Y | N | YY | Y | YY |
urlencode | Y | N | Y | N | N | N |
rawurlencode | Y | YY | Y | Y | N | Y |
encodeURI | N | Y | N | Y | Y | Y |
encodeURIComponent | Y | YY | Y | Y | N | Y |
上表中的YY和Y同含义,老许仅以YY表示在Go中推荐使用url.PathEscape进行编码,同时在PHP和JS中分别推荐使用rawurldecode和decodeURIComponent进行解码。
在实际的开发过程中,Gopher一定会存在需要解码的场景,此时就需要和URL编码方进行沟通以得到合适的方式解码。
对值进行编码
那有没有通用的不需要URL编解码的方式呢?毫无疑问是有的!以base32编码为例,其编码字符集为A-Z和数字2-7,此时对值进行base32编码后就无需url编码了。
最后,衷心希望本文能够对各位读者有一定的帮助。
本文使用环境分别为PHP 7.3.29、go 1.16.6和js Chrome94.0.4606.71的Console
参考
https://www.rfc-editor.org/rfc/rfc2396.txt
https://www.w3schools.com/tags/ref_urlencode.ASP