Swift中如何正确编码字符串以适配PHP urldecode解码？

问题现象 #

Swift中使用内置URL字符集编码带+号的字符串时，+号不会被转义；但PHP的urldecode会把+号解码为空格，导致数据不一致：

// Swift代码
let data = "some+test"
let encodedData = data.addingPercentEncoding(withAllowedCharacters: .urlHostAllowed) // 输出: some+test
sendToMyServer(encodedData)

// PHP代码
$encodedData = $receivedData; // 接收值: some+test
$decodedData = urldecode($encodedData); // 输出: some text

Swift所有内置URL字符集都不包含+号作为需要转义的字符：

URLFragmentAllowedCharacterSet  "#%<>[\]^`{|}
URLHostAllowedCharacterSet      "#%/<>?@\^`{|}
URLPasswordAllowedCharacterSet  "#%/:<>?@[\]^`{|}
URLPathAllowedCharacterSet      "#%;<>?[\]^`{|}
URLQueryAllowedCharacterSet     "#%<>[\]^`{|}
URLUserAllowedCharacterSet      "#%/:<>?@[\]^`

PHP为何会把+号解码为空格？ #

这是因为urldecode遵循application/x-www-form-urlencoded表单提交规范——该规范中会把空格编码为+号，所以解码时会反向将+还原为空格。而Swift的addingPercentEncoding是针对URL各组成部分（host、path等）的编码逻辑，这些场景下+是合法字符，无需转义，两者基于不同的编码规范，因此产生冲突。

正确解决方式 #

方案1：Swift中手动转义+号 #

直接将字符串中的+号替换为其URL编码形式%2B，再进行常规编码：

let data = "some+test"
let escapedData = data.replacingOccurrences(of: "+", with: "%2B")
let encodedData = escapedData.addingPercentEncoding(withAllowedCharacters: .urlHostAllowed)
sendToMyServer(encodedData)

此时PHP端接收的是some%2Btest，urldecode解码后会得到正确的some+test。

方案2：PHP改用rawurldecode解码 #

rawurldecode遵循RFC 3986 URL规范，不会将+号视为空格的编码形式，仅解码%xx格式的字符：

$encodedData = $receivedData;
$decodedData = rawurldecode($encodedData); // 输出: some+test

注意：如果你的接口同时处理表单提交的application/x-www-form-urlencoded数据（其中+代表空格），此方案会导致空格无法被正确还原，仅适用于纯URL路径/参数中+为原始字符的场景。

方案3：自定义Swift允许字符集 #

基于内置字符集移除+号，让addingPercentEncoding自动转义+号：

var allowedCharacters = CharacterSet.urlHostAllowed
allowedCharacters.remove(charactersIn: "+")
let data = "some+test"
let encodedData = data.addingPercentEncoding(withAllowedCharacters: allowedCharacters) // 输出: some%2Btest
sendToMyServer(encodedData)

此方法安全且无额外风险：+号在URL各部分虽合法，但转义为%2B完全符合规范，不会影响URL解析，PHP端无论用urldecode还是rawurldecode都能正确还原。

PHP urldecode的其他注意事项 #

• 避免双重解码：$_GET、$_POST、$_REQUEST超全局变量会自动对数据进行urldecode处理，手动再次调用urldecode会导致双重解码（比如%2B先转成+，再被转成空格）。
• 保留字符处理：urldecode会解码所有%xx格式字符，包括URL中的保留字符（如/、?），因此Swift端需确保这些字符已通过对应允许字符集正确转义，否则可能导致URL解析错误。
• 编码严格性：rawurldecode要求%后必须跟两位十六进制字符，而urldecode对不规范编码（如%3）的处理更宽松，建议始终生成规范的URL编码数据。

内容的提问来源于stack exchange，提问作者Andrei Herford