怎樣使用json_last_error_msg 函數來優化前端與後端之間的數據傳輸格式？

gitbox 2025-09-21

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 本文與 PHP 相關，用於演示如何使用 json_last_error_msg 優化數據傳輸</span></span><span>
</span><span><span class="hljs-comment">// -------------------------------</span></span><span>

</span><span><span class="hljs-comment"># 怎樣使用 json_last_error_msg 函數來優化前端與後端之間的數據傳輸格式？</span></span><span>

在現代 Web 開發中，前後端的數據交互幾乎離不開 JSON 格式。前端通過 JavaScript 將數據封裝為 JSON 對象，再傳遞到後端；後端則使用 PHP 對 JSON 字符串進行解析和處理。然而，數據在傳輸和解析過程中很容易出現格式錯誤，例如編碼問題、缺少引號或語法不規範。如果這些錯誤沒有被及時捕獲，就可能導致程序運行異常甚至數據丟失。為了更好地優化前後端之間的數據傳輸格式，`</span><span><span class="hljs-title function_ invoke__">json_last_error_msg</span></span><span>()` 函數便成為了一個十分實用的工具。

</span><span><span class="hljs-comment">## 一、什麼是 `json_last_error_msg()`</span></span><span>

在 PHP 中，當我們使用 `</span><span><span class="hljs-title function_ invoke__">json_encode</span></span><span>()` 或 `</span><span><span class="hljs-title function_ invoke__">json_decode</span></span><span>()` 函數時，可能會遇到錯誤。PHP 提供了 `</span><span><span class="hljs-title function_ invoke__">json_last_error</span></span><span>()` 來返回錯誤代碼，但這些錯誤代碼是數字，不直觀。而 `</span><span><span class="hljs-title function_ invoke__">json_last_error_msg</span></span><span>()` 则会返回對应的错误信息字符串，更易於開發者理解和調試。

示例：

```php
</span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$data</span></span><span> = </span><span><span class="hljs-string">"{invalidJson: true}"</span></span><span>; </span><span><span class="hljs-comment">// 非法 JSON 字符串</span></span><span>
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-title function_ invoke__">json_decode</span></span><span>(</span><span><span class="hljs-variable">$data</span></span><span>, </span><span><span class="hljs-literal">true</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">json_last_error</span></span><span>() !== JSON_ERROR_NONE) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"解析失敗："</span></span><span> . </span><span><span class="hljs-title function_ invoke__">json_last_error_msg</span></span><span>();
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

輸出結果可能為：

 <span><span>解析失敗：Syntax </span><span><span class="hljs-type">error</span></span><span>
</span></span>

這樣，開發者就能快速定位問題所在，而不是單純依賴錯誤碼。

二、優化前後端數據傳輸的意義

保證數據完整性：在傳輸過程中，若數據結構損壞，可以及時發現並提示前端修正。
提升用戶體驗：錯誤信息清晰明了，便於前端快速定位問題，減少溝通成本。
增強系統健壯性：通過錯誤檢測機制，可以避免因解析錯誤而導致的業務邏輯中斷。

三、結合應用場景的實踐

1. 接收前端數據時驗證

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 假设前端通過 AJAX 發送 JSON 數據</span></span><span>
</span><span><span class="hljs-variable">$jsonInput</span></span><span> = </span><span><span class="hljs-title function_ invoke__">file_get_contents</span></span><span>(</span><span><span class="hljs-string">"php://input"</span></span><span>);
</span><span><span class="hljs-variable">$data</span></span><span> = </span><span><span class="hljs-title function_ invoke__">json_decode</span></span><span>(</span><span><span class="hljs-variable">$jsonInput</span></span><span>, </span><span><span class="hljs-literal">true</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">json_last_error</span></span><span>() !== JSON_ERROR_NONE) {
    </span><span><span class="hljs-title function_ invoke__">http_response_code</span></span><span>(</span><span><span class="hljs-number">400</span></span><span>);
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">json_encode</span></span><span>([
        </span><span><span class="hljs-string">"status"</span></span><span> =&gt; </span><span><span class="hljs-string">"error"</span></span><span>,
        </span><span><span class="hljs-string">"message"</span></span><span> =&gt; </span><span><span class="hljs-string">"無效的 JSON 格式: "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">json_last_error_msg</span></span><span>()
    ]);
    </span><span><span class="hljs-keyword">exit</span></span><span>;
}

</span><span><span class="hljs-comment">// 如果數據格式正确，繼續業務邏輯</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">json_encode</span></span><span>([
    </span><span><span class="hljs-string">"status"</span></span><span> =&gt; </span><span><span class="hljs-string">"success"</span></span><span>,
    </span><span><span class="hljs-string">"data"</span></span><span> =&gt; </span><span><span class="hljs-variable">$data</span></span><span>
]);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

通過這種方式，後端能在第一時間發現JSON 解析問題，並返回友好的錯誤提示。

2. 向前端輸出數據時檢查

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$response</span></span><span> = [
    </span><span><span class="hljs-string">"status"</span></span><span> =&gt; </span><span><span class="hljs-string">"success"</span></span><span>,
    </span><span><span class="hljs-string">"message"</span></span><span> =&gt; </span><span><span class="hljs-string">"操作完成"</span></span><span>,
    </span><span><span class="hljs-string">"data"</span></span><span> =&gt; [</span><span><span class="hljs-string">"id"</span></span><span> =&gt; </span><span><span class="hljs-number">123</span></span><span>, </span><span><span class="hljs-string">"name"</span></span><span> =&gt; </span><span><span class="hljs-string">"測試用戶"</span></span><span>]
];

</span><span><span class="hljs-variable">$jsonOutput</span></span><span> = </span><span><span class="hljs-title function_ invoke__">json_encode</span></span><span>(</span><span><span class="hljs-variable">$response</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">json_last_error</span></span><span>() !== JSON_ERROR_NONE) {
    </span><span><span class="hljs-title function_ invoke__">error_log</span></span><span>(</span><span><span class="hljs-string">"JSON 編碼失敗："</span></span><span> . </span><span><span class="hljs-title function_ invoke__">json_last_error_msg</span></span><span>());
    </span><span><span class="hljs-title function_ invoke__">http_response_code</span></span><span>(</span><span><span class="hljs-number">500</span></span><span>);
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"服务器數據格式错误"</span></span><span>;
    </span><span><span class="hljs-keyword">exit</span></span><span>;
}

</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$jsonOutput</span></span><span>;
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

這樣可以確保後端返回給前端的JSON 數據始終是合法且可解析的。

四、總結

在前後端的數據傳輸中，JSON 是核心格式。但在處理過程中難免出現錯誤。 json_last_error_msg()為開發者提供了一種直觀的方式來捕獲和描述錯誤，不僅有助於快速定位問題，還能顯著提升系統的健壯性與用戶體驗。通過合理地將該函數應用於數據接收與輸出環節，可以有效地優化前後端之間的數據傳輸格式，讓系統運行更加穩定可靠。

 <span></span>

json_last_error_msg