PHP 判斷字串是否為合法 JSON 格式的最佳實踐

前言

API 開發中頻繁需要驗證輸入字串是否為合法 JSON。PHP 5.3+ 提供 json_last_error() 精確判斷解碼錯誤類型，配合 json_decode() 可建立可靠的檢測函數。本文提供多種版本檢測函數、常見陷阱與編碼注意事項。

核心原理

• json_decode() 解碼失敗回傳 null，但合法 JSON null 也回傳 null，單靠回傳值無法區分。
• json_last_error() 回傳最後一次解碼錯誤代碼，JSON_ERROR_NONE 表示無錯誤。
• 輸入字串**必須為 UTF-8 編碼**，否則解碼失敗或產生錯誤字符。

推薦檢測函數（PHP 5.3+）

function is_json($string) {
    json_decode($string);
    return json_last_error() === JSON_ERROR_NONE;
}

舊版 PHP 相容寫法（PHP 5.2）

function is_not_json($str) {
    return is_null(json_decode($str));
}
// 僅能粗略判斷，無法區分「合法 null」與「解碼失敗」

json_last_error() 常見錯誤代碼對照表

進階解析函數：提取 JSON 片段並解碼

function analyJson($json_str) {
    // 移除雙反斜線（常見於雙重編碼）
    $json_str = str_replace('\\\\', '', $json_str);
    // 以正則提取第一個 { ... } 區塊
    $out_arr = array();
    if (preg_match('/\{.*\}/s', $json_str, $out_arr)) {
        return json_decode($out_arr[0], true);  // 關聯陣列模式
    }
    return false;
}

編碼陷阱與解決方案

總結

判斷 JSON 合法性：**PHP 5.3+ 必用 json_last_error() === JSON_ERROR_NONE**，嚴謹可靠。務必確認輸入為 UTF-8，必要時先轉碼。進階場景可結合正則提取片段再解碼，提升容錯能力。