萬盛學電腦網

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

PHP輸出中文JSON不轉義:JSON_UNESCAPED_UNICODE、urlencode繞過、流式編碼器三種方案

PHPjson_encode默認將中文轉為\uXXXX Unicode轉義序列,雖標準合規但調試困難、傳輸體積增大。本文提供三種輸出可讀中文JSON方案,並分析性能與適用場景。

現象演示

$arr = ['msg' => '芒果小站', 'data' => ['用戶', '訂單']];
echo json_encode($arr);
// {"msg":"\u8292\u679c\u5c0f\u7ad9","data":["\u7528\u6237","\u8ba2\u5355"]}

方案一:JSON_UNESCAPED_UNICODE(推薦,PHP 5.4+)

echo json_encode($arr, JSON_UNESCAPED_UNICODE);
// {"msg":"芒果小站","data":["用戶","訂單"]}
// 組合常用標誌
$flags = JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT;
echo json_encode($arr, $flags);

方案二:urlencode繞過(兼容PHP 5.3及極舊版本)

function json_encode_chinese(mixed $data): string {
    array_walk_recursive($data, function(&$v) {
        if (is_string($v)) $v = urlencode($v);
    });
    $json = json_encode($data);
    return urldecode($json);
}
echo json_encode_chinese($arr); // 同方案一輸出

原理

  1. 遞歸urlencode將中文編碼為%E8%8A%92%E6%9E%9C...(ASCII安全字符)。
  2. json_encode不再觸發Unicode轉義(因已無非ASCII字符)。
  3. urldecode還原為UTF-8中文。

方案三:流式編碼器(大數據、內存受限)

composer require niaho/json-streaming-encoder
use Niaho\JsonStreamingEncoder\JsonStreamingEncoder;

$encoder = new JsonStreamingEncoder(fopen('php://output', 'w'), JSON_UNESCAPED_UNICODE);
$encoder->startObject()
    ->key('msg')->value('芒果小站')
    ->key('data')->startArray()
    ->value('用戶')->value('訂單')
    ->endArray()
    ->endObject()
    ->flush();

性能與內存對比(10萬中文字符串數組)

方案耗時峰值內存PHP版本要求
JSON_UNESCAPED_UNICODE基準基準>= 5.4
urlencode繞過+40%+30%>= 5.0
JsonStreamingEncoder+20%**恆定低**>= 7.1

常見問題

  • JSON_UNESCAPED_UNICODE無效:確認PHP版本≥5.4,且文件編碼為UTF-8無BOM。
  • 前端解析報錯:檢查是否雙重編碼(如echo json_encode(json_encode($arr)))。
  • 數據庫存儲:MySQLJSON類型字段直接存儲PHP生成的JSON字符串,查詢時JSON_UNQUOTE(JSON_EXTRACT(...))。

現代PHP項目**直接使用JSON_UNESCAPED_UNICODE**即可,舊版本升級或用urlencode繞過,大數據場景引入流式編碼器。

copyright © 萬盛學電腦網 all rights reserved