PHP JSON

В этой главе мы расскажем, как использовать PHP для кодирования и декодирования объектов JSON.

Настройка окружения

Расширение JSON встроено в PHP 5.2.0 и выше.

Функции JSON

ФункцияОписание
json_encode Кодирует переменную в JSON
json_decodeДекодирует строку JSON в переменную PHP
json_last_errorВозвращает последнюю возникшую ошибку

json_encode

PHP json_encode() используется для кодирования переменной в JSON. Эта функция возвращает данные JSON в случае успеха или FALSE в случае неудачи.

Синтаксис

string json_encode ( $value [, $options = 0 ] )

Parameters

  • value: Значение для кодирования. Эта функция работает только с данными в кодировке UTF-8.

  • options: Битовая маска, состоящая из следующих констант: JSON_HEX_QUOT, JSON_HEX_TAG, JSON_HEX_AMP, JSON_HEX_APOS, JSON_NUMERIC_CHECK, JSON_PRETTY_PRINT, JSON_UNESCAPED_SLASHES, JSON_FORCE_OBJECT, JSON_PRESERVE_ZERO_FRACTION, JSON_UNESCAPED_UNICODE, JSON_PARTIAL_OUTPUT_ON_ERROR.

    Следует отметить, что при использовании опции JSON_UNESCAPED_UNICODE, если мы не хотим, чтобы китайские символы кодировались, мы можем выбрать эту опцию.

Пример

Следующий пример демонстрирует, как преобразовать массив PHP в данные формата JSON:

<?php
   $arr = array('a' => 1, 'b' => 2, 'c' => 3, 'd' => 4, 'e' => 5);
   echo json_encode($arr);
?>

Вывод вышеприведённого кода:

{"a":1,"b":2,"c":3,"d":4,"e":5}

Следующий пример демонстрирует, как преобразовать объект PHP в данные формата JSON:

Пример

<?php
   class Emp {
       public $name = "";
       public $hobbies  = "";
       public $birthdate = "";
   }
   $e = new Emp();
   $e->name = "sachin";
   $e->hobbies  = "sports";
   $e->birthdate = date('m/d/Y h:i:s a', "8/5/1974 12:20:03 p");
   $e->birthdate = date('m/d/Y h:i:s a', strtotime("8/5/1974 12:20:03"));

   echo json_encode($e);
?>

Вывод вышеприведённого кода:

{"name":"sachin","hobbies":"sports","birthdate":"08\/05\/1974 12:20:03 pm"}

Использование опции JSON_UNESCAPED_UNICODE

<?php
   $arr = array('пример' => 'Учебник для новичков', 'taobao' => 'Taobao');
   echo json_encode($arr); //Кодировать китайский
   echo PHP_EOL;  //Символ новой строки
   echo json_encode($arr, JSON_UNESCAPED_UNICODE);  //Не кодировать китайский
?>

Вывод вышеприведённого кода:

{"example":"\u83dc\u9e1f\u6559\u7a0b","taobao":"\u6dd8\u5b9d\u7f51"}
{"example":"Example","taobao":"淘宝网"}

json_decode

Функция PHP json_decode() используется для декодирования строки JSON и преобразования её в переменную PHP.

Синтаксис

mixed json_decode ($json_string [,$assoc = false [, $depth = 512 [, $options = 0 ]]])

Parameters

  • json_string: Строка JSON, которую нужно декодировать. Она должна быть в кодировке UTF-8.

  • assoc: Если этот параметр равен TRUE, возвращается массив; если FALSE — объект.

  • depth: Целочисленный параметр, задающий глубину рекурсии.

  • options: Битовая маска. В настоящее время поддерживается только JSON_BIGINT_AS_STRING.

Пример

В следующем примере показано, как декодировать данные JSON:

Пример

<?php
   $json = '{"a":1,"b":2,"c":3,"d":4,"e":5}';

   var_dump(json_decode($json));
   var_dump(json_decode($json, true));
?>

Вывод вышеприведённого кода:

object(stdClass)#1 (5) {
    ["a"] => int(1)
    ["b"] => int(2)
    ["c"] => int(3)
    ["d"] => int(4)
    ["e"] => int(5)
}

array(5) {
    ["a"] => int(1)
    ["b"] => int(2)
    ["c"] => int(3)
    ["d"] => int(4)
    ["e"] => int(5)
}
Другие расширения