萬盛學電腦網

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

PHP 5.4 以下版本解決 json_encode 中文 Unicode 轉義問題

前言

PHP 5.4 前 json_encode 強制將中文轉為 \uXXXX Unicode 逃逸序列,導致與 Java 等語言對接時簽名驗證失敗。本文提供相容 PHP 5.3 的 json_encode_ex() 替代函數,實現中文不轉義輸出。

問題示例

<?php
$data = ['orderCode' => '1401160935542399', 'creator' => '生活用品測試小屋'];
echo json_encode($data);
// 輸出: {"orderCode":"1401160935542399","creator":"\u751f\u6d3b\u7528\u54c1\u6d4b\u8bd5\u5c0f\u5c4b"}
// Java 端若直接對原始字串簽名,會與 PHP 端簽名不一致
?>

相容性解決方案:json_encode_ex()

<?php
// 版本自適應封裝
if (version_compare(PHP_VERSION, '5.4.0') >= 0) {
    function json_encode_ex($var) {
        return json_encode($var, JSON_UNESCAPED_UNICODE);
    }
} else {
    function json_encode_ex($var) {
        if (is_null($var)) return 'null';
        if ($var === true) return 'true';
        if ($var === false) return 'false';
        if (is_scalar($var)) {
            // 簡單標量:字串、數字、布林
            static $reps = [
                ['"', '\\', "\n", "\t", "\r", "\b", "\f"],
                ['\\"', '\\\\', '\n', '\t', '\r', '\b', '\f']
            ];
            return '"' . str_replace($reps[0], $reps[1], (string)$var) . '"';
        }
        if (!is_array($var)) throw new Exception('JSON encoder error!');

        // 判斷是關聯陣列還是索引陣列
        $isMap = false;
        $i = 0;
        foreach (array_keys($var) as $k) {
            if (!is_int($k) || $i++ !== $k) {
                $isMap = true;
                break;
            }
        }

        $parts = [];
        if ($isMap) {
            foreach ($var as $k => $v) {
                $parts[] = '"' . $k . '":' . json_encode_ex($v);
            }
            return '{' . implode(',', $parts) . '}';
        } else {
            foreach ($var as $v) {
                $parts[] = json_encode_ex($v);
            }
            return '[' . implode(',', $parts) . ']';
        }
    }
}

// 使用方式完全相容內建函數
echo json_encode_ex(['釣魚島' => '中國的', 'list' => [1,2,3]]);
// 輸出: {"釣魚島":"中國的","list":[1,2,3]}  中文不轉義!
?>

原理解析

  • 遞迴處理陣列/物件,標量直接輸出 UTF-8 字串。
  • 關鍵點:不對中文字元進行 \uXXXX 轉義,直接保留原始 UTF-8 位元組。
  • 支援多維陣列、關聯陣列混合結構。

升級建議

強烈建議升級 PHP ≥ 5.6(最佳 7.4+ / 8.x),原生支援 JSON_UNESCAPED_UNICODE、JSON_THROW_ON_ERROR、效能大幅提升。若受限於舊環境,此函數可作為過渡方案。

copyright © 萬盛學電腦網 all rights reserved