PHP中json_decode的用法

一、JSON簡介

JSON（JavaScript Object Notation）是一種輕量級的數據交換格式，易於閱讀和編寫。它基於JavaScript語言的一個子集，但是可以被多種編程語言讀取和編寫，包括PHP。

JSON格式提供了一種結構化數據的表示方法，它由鍵值對構成的集合組合而成。例如，以下是一個JSON格式的對象：

{
    "name": "John Doe",
    "email": "johndoe@example.com",
    "age": 25,
    "is_active": true,
    "hobbies": ["reading", "traveling", "photography"],
    "address": {
        "street": "123 Main St",
        "city": "New York",
        "state": "NY",
        "zip": "10001"
    }
}

JSON格式主要有兩種結構：

• 對象：由花括弧「{}」包圍，包含一系列鍵值對，每個鍵值對以冒號「:」分隔，不同鍵值對之間以逗號「,」分隔。
• 數組：由方括弧「[]」包圍，包含一系列值，不同值之間以逗號「,」分隔。

二、json_decode函數

json_decode函數是PHP的一個內置函數，它用於將JSON格式的字元串轉換為PHP的對象或數組。

json_decode函數的語法如下：

mixed json_decode(string $json_str, bool $assoc = false, int $depth = 512, int $options = 0 )

參數解釋：

• $json_str：表示待解碼的JSON格式的字元串。
• $assoc：可選參數，默認為false，表示返回PHP的對象。如果設置為true，則返回PHP的關聯數組。
• $depth：可選參數，默認為512，表示最大解析深度。
• $options：可選參數，表示解析選項。

示例代碼：

//JSON格式的字元串
$json_str = '{
    "name": "John Doe",
    "email": "johndoe@example.com",
    "age": 25,
    "is_active": true,
    "hobbies": ["reading", "traveling", "photography"],
    "address": {
        "street": "123 Main St",
        "city": "New York",
        "state": "NY",
        "zip": "10001"
    }
}';

//將JSON格式的字元串解碼為PHP的對象
$obj = json_decode($json_str);

//列印結果
var_dump($obj);

輸出結果：

object(stdClass)#1 (6) {
  ["name"]=>
  string(8) "John Doe"
  ["email"]=>
  string(18) "johndoe@example.com"
  ["age"]=>
  int(25)
  ["is_active"]=>
  bool(true)
  ["hobbies"]=>
  array(3) {
    [0]=>
    string(7) "reading"
    [1]=>
    string(9) "traveling"
    [2]=>
    string(12) "photography"
  }
  ["address"]=>
  object(stdClass)#2 (4) {
    ["street"]=>
    string(11) "123 Main St"
    ["city"]=>
    string(8) "New York"
    ["state"]=>
    string(2) "NY"
    ["zip"]=>
    string(5) "10001"
  }
}

從輸出結果可以看出，json_decode函數將JSON格式的字元串成功地解碼為一個PHP的對象，對象中包含了相應的鍵值對、數組和嵌套對象。

三、使用示例

1. 解析JSON格式的字元串

使用json_decode函數可以輕鬆地將JSON格式的字元串轉換為PHP的對象或數組。

//JSON格式的字元串
$json_str = '{
    "name": "John Doe",
    "email": "johndoe@example.com",
    "age": 25,
    "is_active": true,
    "hobbies": ["reading", "traveling", "photography"],
    "address": {
        "street": "123 Main St",
        "city": "New York",
        "state": "NY",
        "zip": "10001"
    }
}';

//將JSON格式的字元串解碼為PHP的對象
$obj = json_decode($json_str);

//列印結果
var_dump($obj);

輸出結果：

object(stdClass)#1 (6) {
  ["name"]=>
  string(8) "John Doe"
  ["email"]=>
  string(18) "johndoe@example.com"
  ["age"]=>
  int(25)
  ["is_active"]=>
  bool(true)
  ["hobbies"]=>
  array(3) {
    [0]=>
    string(7) "reading"
    [1]=>
    string(9) "traveling"
    [2]=>
    string(12) "photography"
  }
  ["address"]=>
  object(stdClass)#2 (4) {
    ["street"]=>
    string(11) "123 Main St"
    ["city"]=>
    string(8) "New York"
    ["state"]=>
    string(2) "NY"
    ["zip"]=>
    string(5) "10001"
  }
}

2. 解析JSON格式的文件

有時候我們需要解析JSON格式的文件，首先需要讀取文件內容，然後將內容傳遞給json_decode函數進行解碼。

//JSON格式的文件路徑
$file_path = 'data.json';

//讀取文件內容
$json_str = file_get_contents($file_path);

//將JSON格式的字元串解碼為PHP的對象
$obj = json_decode($json_str);

//列印結果
var_dump($obj);

3. 將JSON格式字元串轉換為關聯數組

通過json_decode函數的第二個參數$assoc可以將JSON格式的字元串轉換為PHP的關聯數組。

//JSON格式的字元串
$json_str = '{
    "name": "John Doe",
    "email": "johndoe@example.com",
    "age": 25,
    "is_active": true,
    "hobbies": ["reading", "traveling", "photography"],
    "address": {
        "street": "123 Main St",
        "city": "New York",
        "state": "NY",
        "zip": "10001"
    }
}';

//將JSON格式的字元串解碼為PHP的關聯數組
$arr = json_decode($json_str, true);

//列印結果
var_dump($arr);

輸出結果：

array(6) {
  ["name"]=>
  string(8) "John Doe"
  ["email"]=>
  string(18) "johndoe@example.com"
  ["age"]=>
  int(25)
  ["is_active"]=>
  bool(true)
  ["hobbies"]=>
  array(3) {
    [0]=>
    string(7) "reading"
    [1]=>
    string(9) "traveling"
    [2]=>
    string(12) "photography"
  }
  ["address"]=>
  array(4) {
    ["street"]=>
    string(11) "123 Main St"
    ["city"]=>
    string(8) "New York"
    ["state"]=>
    string(2) "NY"
    ["zip"]=>
    string(5) "10001"
  }
}

4. 解析含有特殊字元的JSON格式字元串

如果JSON格式的字元串中包含有特殊字元，例如斜杠「/」，轉義字元「\」，則需要通過json_decode函數的第四個參數$options來進行處理。

//JSON格式的字元串
$json_str = '{"path": "\\\\server\\\\share"}';

//將JSON格式的字元串解碼為PHP的對象
$obj = json_decode($json_str, false, 512, JSON_UNESCAPED_SLASHES);

//列印結果
var_dump($obj);

輸出結果：

object(stdClass)#1 (1) {
  ["path"]=>
  string(14) "\\server\\share"
}

四、總結

json_decode函數是PHP的一個內置函數，用於將JSON格式的字元串轉換為PHP的對象或數組。在使用json_decode函數時，可以通過指定第二個參數來決定返回PHP的對象還是關聯數組。此外，如果JSON格式的字元串中包含有特殊字元，還可以通過指定第四個參數來進行處理。