JSON (JavaScript Object Notation) – текстовый формат обмена данными, основанный на JavaScript, который представляет собой набор пар {ключ: значение}. Значение может быть массивом, числом, строкой и булевым значением.
В PHP поддержка JSON появилась с версии 5.2.0 и работает только с кодировкой UTF-8.
json_encode($value, $options) – кодирует массив или объект в JSON.
$array = array(
'1' => 'Значение 1',
'2' => 'Значение 2',
'3' => 'Значение 3',
'4' => 'Значение 4',
'5' => 'Значение 5'
);
$json = json_encode($array);
echo $json;
{"1":"\u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 1","2":"\u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 2","3":"\u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 3","4":"\u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 4","5":"\u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 5"}
Как видно кириллица кодируется, исправляется это добавлением опции JSON_UNESCAPED_UNICODE
.
{"1":"Значение 1","2":"Значение 2","3":"Значение 3","4":"Значение 4","5":"Значение 5"}
Далее такую строку можно сохранить в файл, или отдать в браузер, например при AJAX запросах.
Функция json_decode($json) преобразует строку в объект:
$json = '{"1":"Значение 1","2":"Значение 2","3":"Значение 3","4":"Значение 4","5":"Значение 5"}';
$array = json_decode($json);
print_r($array);
stdClass Object
(
[1] => Значение 1
[2] => Значение 2
[3] => Значение 3
[4] => Значение 4
[5] => Значение 5
)
Если добавить вторым аргументом true
, то произойдёт преобразование в массив:
$json = '{"1":"Значение 1","2":"Значение 2","3":"Значение 3","4":"Значение 4","5":"Значение 5"}';
$array = json_decode($json, true);
print_r($array);
Array
(
[1] => Значение 1
[2] => Значение 2
[3] => Значение 3
[4] => Значение 4
[5] => Значение 5
)
json_decode()
возвращает NULL
, если в объекте есть ошибки, посмотреть их можно с помощью функции json_last_error()
:
$json = '{"1:"Значение 1"}';
$array = json_decode($json, true);
switch (json_last_error()) {
case JSON_ERROR_NONE:
echo 'Ошибок нет';
break;
case JSON_ERROR_DEPTH:
echo 'Достигнута максимальная глубина стека';
break;
case JSON_ERROR_STATE_MISMATCH:
echo 'Некорректные разряды или несоответствие режимов';
break;
case JSON_ERROR_CTRL_CHAR:
echo 'Некорректный управляющий символ';
break;
case JSON_ERROR_SYNTAX:
echo 'Синтаксическая ошибка, некорректный JSON';
break;
case JSON_ERROR_UTF8:
echo 'Некорректные символы UTF-8, возможно неверно закодирован';
break;
default:
echo 'Неизвестная ошибка';
break;
}
Посмотреть значения констант JSON:
$constants = get_defined_constants(true);
foreach ($constants['json'] as $name => $value) {
echo $name . ': ' . $value . '<br>';
}
JSON_HEX_TAG: 1
JSON_HEX_AMP: 2
JSON_HEX_APOS: 4
JSON_HEX_QUOT: 8
JSON_FORCE_OBJECT: 16
JSON_NUMERIC_CHECK: 32
JSON_UNESCAPED_SLASHES: 64
JSON_PRETTY_PRINT: 128
JSON_UNESCAPED_UNICODE: 256
JSON_PARTIAL_OUTPUT_ON_ERROR: 512
JSON_PRESERVE_ZERO_FRACTION: 1024
JSON_UNESCAPED_LINE_TERMINATORS: 2048
JSON_OBJECT_AS_ARRAY: 1
JSON_BIGINT_AS_STRING: 2
JSON_ERROR_NONE: 0
JSON_ERROR_DEPTH: 1
JSON_ERROR_STATE_MISMATCH: 2
JSON_ERROR_CTRL_CHAR: 3
JSON_ERROR_SYNTAX: 4
JSON_ERROR_UTF8: 5
JSON_ERROR_RECURSION: 6
JSON_ERROR_INF_OR_NAN: 7
JSON_ERROR_UNSUPPORTED_TYPE: 8
JSON_ERROR_INVALID_PROPERTY_NAME: 9
JSON_ERROR_UTF16: 10
Если вы хотите распарсить JS объект из HTML страницы или файла, то скорее всего json_decode вернет ошибку т.к. в коде будут управляющие символы или BOM. Удалить их можно следующим образом:
$json = '{...}';
// Удаление управляющих символов
for ($i = 0; $i <= 31; ++$i) {
$json = str_replace(chr($i), '', $json);
}
// Удаление символа Delete
$json = str_replace(chr(127), '', $json);
// Удаление BOM
if (0 === strpos(bin2hex($json), 'efbbbf')) {
$json = substr($json, 3);
}
$res = json_decode($json, true);
print_r($res);
Некоторые сервисы требуют чтобы запросы к ним осуществлялись в формате JSON, такой запрос можно сформировать в CURL:
$data = array(
'name' => 'snipp.ru'
'text' => 'Отправка сообщения',
);
$ch = curl_init('https://example.com');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$res = curl_exec($ch);
curl_close($ch);
А также могут обратится к вашим скриптам в таком формате, чтение JSON запроса.