萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP JSON 中文編碼問題完美解決:urlencode 技巧與 json_encode 選項

問題現象


$arr = ['catname' => '一聚教程網'];
echo json_encode($arr); 
// GBK/GB2312 頁面輸出:{"catname":null}
// UTF-8 頁面輸出:{"catname":"\u4e00\u804a\u6559\u7a0b\u7f51"} (可讀但非直觀)

根本原因

  • json_encode **強制要求 UTF-8 輸入**;非 UTF-8 字符會返回 null(PHP 5.5+ 拋出錯誤)。
  • UTF-8 下默認輸出 Unicode 轉義序列(\uXXXX),雖標準但調試不便。

方案一:統一轉 UTF-8 再編碼(兼容舊項目)


// 入口統一轉碼
function toUtf8($data) {
    if (is_array($data)) return array_map('toUtf8', $data);
    if (is_string($data)) {
        $enc = mb_detect_encoding($data, ['GBK','GB2312','UTF-8'], true);
        return $enc && $enc !== 'UTF-8' ? iconv($enc, 'UTF-8//IGNORE', $data) : $data;
    }
    return $data;
}

$arr = toUtf8($arr);
echo json_encode($arr, JSON_UNESCAPED_UNICODE); // PHP 5.4+
// {"catname":"一聚教程網"}

方案二:urlencode + urldecode 繞過 Unicode 轉義(經典技巧)


$arr = ['name' => '中文字符串', 'value' => 'test'];
foreach ($arr as $k => $v) $arr[$k] = urlencode($v);
echo urldecode(json_encode($arr));
// {"name":"中文字符串","value":"test"}

原理:urlencode 將中文轉為 %XX%XX ASCII 字符,json_encode 不再轉義,最後 urldecode 還原。

方案三:PHP 5.4+ 官方選項 JSON_UNESCAPED_UNICODE(首選)


echo json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
// JSON_UNESCAPED_SLASHES 避免 / 被轉義為 \/

直接輸出可讀中文,無需額外處理,性能最優。

完整最佳實踐封裝


function jsonEncode($data, $options = 0) {
    // 確保 UTF-8
    array_walk_recursive($data, function(&$v) {
        if (is_string($v)) {
            $enc = mb_detect_encoding($v, ['UTF-8','GBK','GB2312'], true);
            if ($enc && $enc !== 'UTF-8') $v = iconv($enc, 'UTF-8//IGNORE', $v);
        }
    });
    // 默認開啟不轉義 Unicode 與斜槓
    return json_encode($data, $options | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
}

解碼端注意


$data = json_decode($json, true); // 關鍵:第二參數 true 返回關聯數組
// json_decode 默認返回 stdClass 對象

常見坑

  • 字符串含控制字符(\u0000-\u001F)會導致 json_encode 失敗,需預先過濾。
  • 大數據量編碼時設置 ini_set('memory_limit', '256M')。
  • 浮點數精度:json_encode(0.1+0.2) → 0.30000000000000004,前端需注意。
copyright © 萬盛學電腦網 all rights reserved