萬盛學電腦網

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

PHP json_encode 不轉義中文 (Unicode) 的版本相容解決方案

預設 json_encode() 會將中文轉為 \uXXXX Unicode 逃逸序列,導致資料庫儲存、日誌閱讀、API 除錯困擾。本文針對 PHP 5.3 與 5.4+ 兩大版本提供最佳實踐方案。

PHP 5.4+ 原生支援 (首選)

PHP 5.4 引入 JSON_UNESCAPED_UNICODE 選項,一行解決:

$json = json_encode($data, JSON_UNESCAPED_UNICODE);
  • 同時可搭配 JSON_UNESCAPED_SLASHES 避免 / 被轉義。
  • JSON_PRETTY_PRINT 可產生縮排易讀格式。

PHP 5.3 相容方案 (透過 mb_encode_numericentity 繞過)

原理:將非 ASCII 字元 (>= 0x80) 先轉為 HTML 數值實體 (如 中),json_encode 不會轉義實體,最後再還原。

function my_json_encode($arr) {
    array_walk_recursive($arr, function(&$item, $key) {
        if (is_string($item)) {
            $item = mb_encode_numericentity($item, array(0x80, 0xFFFF, 0, 0xFFFF), 'UTF-8');
        }
    });
    return mb_decode_numericentity(json_encode($arr), array(0x80, 0xFFFF, 0, 0xFFFF), 'UTF-8');
}

運作流程圖解

  1. 遞迴遍歷陣列所有字串值。
  2. mb_encode_numericentity 將中文等非 ASCII 字元轉為 &#數值; 形式。
  3. json_encode 只見 ASCII 與實體字串,不再產生 \uXXXX。
  4. mb_decode_numericentity 將實體還原為原始 UTF-8 字元。

線上 JSON 工具推薦 (除錯利器)

版本檢查與升級建議

php -v  // 確認版本
// PHP 5.3 已於 2014 年停止安全更新,強烈建議升級至 7.4+ 或 8.x

若專案仍滯留 5.3,請將 my_json_encode 封裝為工具函數統一替換專案內所有 json_encode 呼叫,並加入單元測試確保行為一致。

copyright © 萬盛學電腦網 all rights reserved