預設 json_encode() 會將中文轉為 \uXXXX Unicode 逃逸序列,導致資料庫儲存、日誌閱讀、API 除錯困擾。本文針對 PHP 5.3 與 5.4+ 兩大版本提供最佳實踐方案。
PHP 5.4 引入 JSON_UNESCAPED_UNICODE 選項,一行解決:
$json = json_encode($data, JSON_UNESCAPED_UNICODE);
JSON_UNESCAPED_SLASHES 避免 / 被轉義。JSON_PRETTY_PRINT 可產生縮排易讀格式。原理:將非 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');
}
mb_encode_numericentity 將中文等非 ASCII 字元轉為 數值; 形式。json_encode 只見 ASCII 與實體字串,不再產生 \uXXXX。mb_decode_numericentity 將實體還原為原始 UTF-8 字元。php -v // 確認版本
// PHP 5.3 已於 2014 年停止安全更新,強烈建議升級至 7.4+ 或 8.x
若專案仍滯留 5.3,請將 my_json_encode 封裝為工具函數統一替換專案內所有 json_encode 呼叫,並加入單元測試確保行為一致。