如何对查询参数进行UTF-8编码？API调用编码问题求助

针对你的JS→PHP→API调用流程，以下是几个可行的排查和解决方法：

1. 确保JS端发送请求时的编码与请求头匹配 #

如果通过表单或application/x-www-form-urlencoded格式发送参数，需注意：

• 对每个参数值单独使用encodeURIComponent编码（不要用encodeURI处理整个URL，易遗漏特殊字符）
• 请求头明确指定UTF-8编码

示例代码（Fetch API）：

const params = new URLSearchParams();
// 单独编码每个参数值
params.append('key', encodeURIComponent('需要UTF-8编码的内容'));

fetch('your-php-script.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'
  },
  body: params
});

如果发送JSON格式：

const data = { key: '需要UTF-8编码的内容' };
fetch('your-php-script.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json; charset=UTF-8'
  },
  body: JSON.stringify(data)
});

2. PHP端接收参数时修正编码 #

PHP默认可能以ISO-8859-1解析GET/POST参数，需手动转成UTF-8：

• 处理GET参数：

// 单个参数转码
$param = mb_convert_encoding($_GET['key'], 'UTF-8', 'ISO-8859-1');
// 批量处理GET参数
foreach ($_GET as $k => $v) {
    $_GET[$k] = mb_convert_encoding($v, 'UTF-8', 'ISO-8859-1');
}

• 处理POST参数（表单提交场景）：

// 单个参数转码
$param = mb_convert_encoding($_POST['key'], 'UTF-8', 'ISO-8859-1');
// 批量处理POST参数
foreach ($_POST as $k => $v) {
    $_POST[$k] = mb_convert_encoding($v, 'UTF-8', 'ISO-8859-1');
}

如果接收JSON格式：

$jsonData = file_get_contents('php://input');
// 检查并修正编码
if (!mb_check_encoding($jsonData, 'UTF-8')) {
    $jsonData = mb_convert_encoding($jsonData, 'UTF-8', 'auto');
}
$data = json_decode($jsonData, true);

3. PHP调用API时强制UTF-8编码 #

用CURL请求API时，需明确设置请求头和参数编码：

$apiUrl = 'https://api-provider.com/endpoint';
$params = [
    'key' => '已转成UTF-8的参数值'
];
// 生成编码后的请求字符串（前提是参数本身为UTF-8）
$postData = http_build_query($params);

$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/x-www-form-urlencoded; charset=UTF-8'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 禁用自动编码处理，避免CURL修改编码
curl_setopt($ch, CURLOPT_ENCODING, '');

$response = curl_exec($ch);
curl_close($ch);

4. 调试编码一致性 #

在每个环节打印并验证编码：

• JS端：console.log(encodeURIComponent('测试内容'))，确认编码结果符合UTF-8的URL编码规则
• PHP端：var_dump(mb_detect_encoding($param))，确认参数为UTF-8编码
• PHP请求API前：打印$postData，对比API要求的编码格式

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