通过FormData和POST传递UTF8字符串到PHP的编码问题及解决

我尝试通过FormData和POST方法将UTF-8字符串从JavaScript传递到PHP，遇到了如下问题：当JavaScript中的zipFilename值为"Misión"时，PHP端读取到的$_POST["downloadzip"]在error_log中显示为"Misi\xc3\xb3n"。

JavaScript代码 #

let formData = new FormData();
formData.append("downloadzip", zipFilename);

// send the request to php
let request = new XMLHttpRequest();
let url = window.location.origin + window.location.pathname;
request.onreadystatechange = function() {
    if (this.readyState === 4) {
        if (this.status >= 200 && this.status < 300) {
            $("#downloading-and-zipping").fadeOut(2000);
        } else {
            $("#error-downloading").show();
        }
    }
};
request.open("POST", url, true);
request.send(formData);

PHP代码 #

if (! empty($_POST) && ! empty($_POST["downloadzip"])) {
    error_log("ORIGINAL " . $_POST["downloadzip"]);
}

原因分析 #

• \xc3\xb3是UTF-8编码中字符ó的十六进制字节表示，字符串本身并没有被错误转换，只是error_log输出时将非ASCII字节转义为十六进制格式展示了。
• FormData默认以multipart/form-data格式编码数据，UTF-8字符会被正确编码为对应字节序列，PHP接收到后也已正确解析为UTF-8字符串，只是日志输出的显示方式造成了误解。

解决方法 #

1. 直接使用字符串 #

$_POST["downloadzip"]本身就是正确的UTF-8字符串，可直接用于业务逻辑（如写入文件、输出到页面），无需额外转换：

if (! empty($_POST) && ! empty($_POST["downloadzip"])) {
    // 输出到页面（需确保页面Content-Type为UTF-8）
    echo $_POST["downloadzip"];
    // 写入文件
    file_put_contents('filename.txt', $_POST["downloadzip"]);
}

2. 验证编码正确性 #

用mb_detect_encoding确认字符串编码：

error_log("字符串编码: " . mb_detect_encoding($_POST["downloadzip"]));
// 正常情况下会输出 UTF-8

3. 让日志显示原始字符 #

若希望error_log直接显示UTF-8字符，需确保PHP日志系统支持UTF-8编码，或者通过htmlspecialchars转换后输出：

error_log("原始字符串: " . htmlspecialchars($_POST["downloadzip"], ENT_QUOTES, 'UTF-8'));

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