PHP JSON 數據編碼和解碼

JSON 的使用場景：

1. 數據表一個字段需要記錄多個信息，如記錄關於用戶的其他信息
2. 數據傳輸，如：API接口返回值、Ajax中實現異步加載
3. 配置文件，如 composer.json 包管理配置文件

在 PHP 中使用 JSON：

JSON 使用最頻繁的兩個操作就是編碼和解析數據，PHP 官方提供了以下 2 個函數實現這兩個操作：

1. json_encode()
2. json_decode()

Encoding and Decoding 

編碼用於將數據綁定到特定格式。需要此過程來保持數據一致性。解碼是一個反向過程，它將編碼的數據還原回其原始形式。

PHP JSON Encode

使用 json_encode 將 PHP 的一些數據類型轉換為 JSON 格式，函數包含 3 個參數，分別為：

• 將要編碼的數據
• 帶有 JSON encode 常量的選項可以反映對編碼行為的影響
• 編碼的深度限制

PHP 中預定義的 JSON 常量

JSON_FORCE_OBJECT
JSON_HEX_QUOT
JSON_HEX_TAG
JSON_HEX_AMP
JSON_HEX_APOS
JSON_INVALID_UTF8_IGNORE
JSON_INVALID_UTF8_SUBSTITUTE
JSON_NUMERIC_CHECK
JSON_PARTIAL_OUTPUT_ON_ERROR
JSON_PRESERVE_ZERO_FRACTION
JSON_PRETTY_PRINT
JSON_UNESCAPED_LINE_TERMINATORS
JSON_UNESCAPED_SLASHES
JSON_UNESCAPED_UNICODE
JSON_THROW_ON_ERROR

Example: PHP json_encode()

<?php
$input_array = array("zero","one","two");
//returns ["zero","one","two"] 

$str_json_format = json_encode($input_array);
print "JSON Formatted String:" . $str_json_format;
//returns {"0":"zero","1":"one","2":"two"}

$obj_json_format = json_encode($input_array, JSON_FORCE_OBJECT);
print "<br/><br/>JSON Object:" . $obj_json_format;
//returns [ "zero", "one", "two" ]

$strJsonFormat_with_space = json_encode($input_array, JSON_PRETTY_PRINT);
print "<br/><br/>JSON Formatted String with white space:" . $strJsonFormat_with_space;

 

PHP JSON Decode

這是 JSON encode 的反向操作，用於將 JSON 編碼的數據轉換為最初編碼的 PHP數據類型。

json_decode 函數包含 4 個參數，分別為：

• 將要解析的 JSON 字符串
• 當該參數為 TRUE 時，將返回 array 而非 object 
• 指定遞歸深度
• JSON 常量
  JSON_BIGINT_AS_STRING, JSON_INVALID_UTF8_IGNORE, JSON_INVALID_UTF8_SUBSTITUTE, JSON_OBJECT_AS_ARRAY, JSON_THROW_ON_ERROR 

返回值：

返回值為 TRUE, FALSE 和 NULL。
如果 json 無法被解碼， 或者編碼數據深度超過了遞歸限制的話，將會返回NULL 

Example: PHP json_encode()

<?php
$str_json_array_decoded = json_decode($str_json_format);
print "<br/><br/>Resultant decoded array from JSON array:<br/>";
print "<PRE>";
print_r($str_json_array_decoded);
print "</PRE>";

$str_objJson_decoded = json_decode($obj_json_format);
print "<br/><br/>Resultant decoded object data from JSON object:<br/>";
print "<PRE>";
print_r($str_objJson_decoded);
print "</PRE>";

$str_jsonAry_decoded = json_decode($obj_json_format,true);
print "<br/><br/>Resultant decoded array data from JSON object:<br/>";
print "<PRE>";
print_r($str_jsonAry_decoded);
print "</PRE>";

 

注意：

1. PHP 可以將任意數據類型轉換為 JSON 格式，除了 resource data
2. JSON 解碼時，必須先去除掉字符串中的反斜杠 "\"，不然會導致解析失敗，可以使用 stripslashes 對字符串進行處理后，再使用 json_decode 解析

如果需要解碼的 JSON 數據中包含有反斜杠 "\"，應該使用如下代碼進行解碼：

$obj = \json_decode(stripslashes($json));