MongoDB\BSON\toJSON
(mongodb >=1.0.0)
MongoDB\BSON\toJSON — Возвращает Legacy Extended JSON представление значения BSON
Описание
$bson
) : stringПреобразует строку BSON в ее » Legacy Extended JSON представление.
Замечание: Существует несколько форматов JSON для представления BSON. Эта функция реализует "строгий режим", определенный в » MongoDB Extended JSON, который был заменен каноническими и упрощенными форматами, определенными в » Спецификации Extended JSON и реализованными MongoDB\BSON\toCanonicalExtendedJSON() и MongoDB\BSON\toRelaxedExtendedJSON() соответственно.
» JSON не поддерживает
NAN и
INF, а
формат Legacy Extended JSON MongoDB не определяет альтернативное
представление для этих значений
(» libbson будет выводить
литералы nan и inf, которые могут не
распознаться, как корректный JSON). Если вы работаете с BSON, который может содержать
неконечные числа, используйте
MongoDB\BSON\toCanonicalExtendedJSON() или
MongoDB\BSON\toRelaxedExtendedJSON().
Список параметров
-
bson(string) -
Значение BSON для преобразования.
Возвращаемые значения
Преобразованное значение JSON.
Ошибки
- Исключение MongoDB\Driver\Exception\UnexpectedValueException выбрасывается, если входные данные не являются ровно одним документом BSON. Возможные причины включают, но не ограничены некоррекстным BSON, лишними данными или неожиданной ошибкой » libbson.
Примеры
Пример #1 Пример использования MongoDB\BSON\toJSON()
<?php
$documents = [
[ 'null' => null ],
[ 'boolean' => true ],
[ 'string' => 'foo' ],
[ 'int32' => 123 ],
[ 'int64' => 4294967295 ],
[ 'double' => 1.0, ],
[ 'nan' => NAN ],
[ 'pos_inf' => INF ],
[ 'neg_inf' => -INF ],
[ 'array' => [ 'foo', 'bar' ]],
[ 'document' => [ 'foo' => 'bar' ]],
[ 'oid' => new MongoDB\BSON\ObjectId('56315a7c6118fd1b920270b1') ],
[ 'dec128' => new MongoDB\BSON\Decimal128('1234.5678') ],
[ 'binary' => new MongoDB\BSON\Binary('foo', MongoDB\BSON\Binary::TYPE_GENERIC) ],
[ 'date' => new MongoDB\BSON\UTCDateTime(1445990400000) ],
[ 'timestamp' => new MongoDB\BSON\Timestamp(1234, 5678) ],
[ 'regex' => new MongoDB\BSON\Regex('pattern', 'i') ],
[ 'code' => new MongoDB\BSON\Javascript('function() { return 1; }') ],
[ 'code_ws' => new MongoDB\BSON\Javascript('function() { return a; }', ['a' => 1]) ],
[ 'minkey' => new MongoDB\BSON\MinKey ],
[ 'maxkey' => new MongoDB\BSON\MaxKey ],
];
foreach ($documents as $document) {
$bson = MongoDB\BSON\fromPHP($document);
echo MongoDB\BSON\toJSON($bson), "\n";
}
?>
Результат выполнения данного примера:
{ "null" : null }
{ "boolean" : true }
{ "string" : "foo" }
{ "int32" : 123 }
{ "int64" : 4294967295 }
{ "double" : 1.0 }
{ "nan" : nan }
{ "pos_inf" : inf }
{ "neg_inf" : -inf }
{ "array" : [ "foo", "bar" ] }
{ "document" : { "foo" : "bar" } }
{ "oid" : { "$oid" : "56315a7c6118fd1b920270b1" } }
{ "dec128" : { "$numberDecimal" : "1234.5678" } }
{ "binary" : { "$binary" : "Zm9v", "$type" : "00" } }
{ "date" : { "$date" : 1445990400000 } }
{ "timestamp" : { "$timestamp" : { "t" : 5678, "i" : 1234 } } }
{ "regex" : { "$regex" : "pattern", "$options" : "i" } }
{ "code" : { "$code" : "function() { return 1; }" } }
{ "code_ws" : { "$code" : "function() { return a; }", "$scope" : { "a" : 1 } } }
{ "minkey" : { "$minKey" : 1 } }
{ "maxkey" : { "$maxKey" : 1 } }
Смотрите также
- MongoDB\BSON\fromJSON() - Возвращает представление BSON значения JSON
- MongoDB\BSON\toCanonicalExtendedJSON() - Возвращает Canonical Extended JSON представление для значения BSON
- MongoDB\BSON\toRelaxedExtendedJSON() - Возвращает Relaxed Extended JSON представление значения BSON
- » MongoDB Extended JSON
- » MongoDB BSON