萬盛學電腦網

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

PHP 使用 JSON:原生函數與舊版本相容方案

JSON 成為主流資料交換格式,PHP 5.2+ 內建 json_encode()/json_decode()。為相容舊版本,需備援方案。

版本相容寫法

function jsonEncode($data) {
    if (function_exists('json_encode')) {
        return json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
    }
    // PHP < 5.2 回退方案
    require_once 'JSON.php'; // PEAR::Services_JSON
    $json = new Services_JSON();
    return $json->encode($data);
}

function jsonDecode($jsonStr, $assoc = true) {
    if (function_exists('json_decode')) {
        return json_decode($jsonStr, $assoc);
    }
    require_once 'JSON.php';
    $json = new Services_JSON();
    return $json->decode($jsonStr);
}

原生函數進階選項(PHP 5.3+)

常見陷阱

  • 資源型別:json_encode($pdo) 會報錯或回傳空物件,需先轉陣列。
  • 遞迴參考:物件循環引用會導致錯誤,PHP 7.3+ 可用 JsonSerializable 介面控制。
  • 深度限制:預設 512 層,超深結構需調整 json_decode($str, true, 512, JSON_THROW_ON_ERROR)。
  • BOM/控制字元:輸入字串含 BOM 或控制字元會解析失敗,預先 preg_replace('/[\x00-\x1F\x7F]/', '', $str) 清理。

PEAR Services_JSON 取得

官方已停止維護,可從 GitHub 下載 JSON.php 放入專案,或用 Composer 安裝現代替代庫 composer require symfony/polyfill-php73(含 JSON 相容)。

copyright © 萬盛學電腦網 all rights reserved
常數說明
JSON_HEX_TAG< > 轉 \u003C \u003E,防 XSS
JSON_HEX_AMP& 轉 \u0026
JSON_HEX_APOS' 轉 \u0027
JSON_HEX_QUOT" 轉 \u0022
JSON_FORCE_OBJECT陣列強制輸出為物件 {} 而非 []
JSON_NUMERIC_CHECK數字字串轉數值(慎用,可能導致大數精度損失)
JSON_UNESCAPED_UNICODE不轉義 Unicode(中文直接顯示,節省體積)
JSON_UNESCAPED_SLASHES不轉義 /(URL 路徑更易讀)
JSON_PRETTY_PRINT美化縮排(開發/除錯用)
JSON_PRESERVE_ZERO_FRACTION浮點數保留 .0(如 1.0 不變 1)