PHP 8.4.0 RC2 available for testing

MongoDB\BSON\toRelaxedExtendedJSON

(mongodb >=1.3.0)

MongoDB\BSON\toRelaxedExtendedJSONВозвращает представление BSON-значения в слабом расширенном JSON-формате

Внимание

Метод УСТАРЕЛ с версии модуля 1.20.0, а в версии 2.0 метод удалят. Вместо этого метода приложениям лучше вызывать метод MongoDB\BSON\Document::toRelaxedExtendedJSON().

Описание

MongoDB\BSON\toRelaxedExtendedJSON(string $bson): string

Метод преобразовывает BSON-строку в представление »  в слабом расширенном JSON-формате . В слабом формате в ущерб точности типов отдают преимущество работе с примитивами JSON-типа. В слабом формате создаются данные вывода для API-интерфейсов к веб-сервисам и такие данных проще воспринимать людям.

Список параметров

bson (string)

Значение BSON для преобразования.

Возвращаемые значения

Метод возвращает JSON-значение, которое сгенерировал путём преобразования BSON-значения.

Ошибки

  • Метод выбрасывает исключение MongoDB\Driver\Exception\UnexpectedValueException, если во входных данных передали больше одного BSON-документа. Возможные причины включают, но не ограничиваются недопустимым BSON-форматом, лишними данными или неожиданной ошибкой » libbson.

Примеры

Пример #1 Пример преобразования BSON-значения в представление в формате Relaxed Extended JSON методом MongoDB\BSON\toRelaxedExtendedJSON()

<?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\toRelaxedExtendedJSON($bson), "\n";
}

?>

Результат выполнения приведённого примера:

{"null": null}
{"boolean": true}
{"string": "foo"}
{"int32": 123}
{"int64": 4294967295}
{"double": 1.0}
{"nan": {"$numberDouble": "NaN"}}
{"pos_inf": {"$numberDouble": "Infinity"}}
{"neg_inf": {"$numberDouble": "-Infinity"}}
{"array": ["foo", "bar"]}
{"document": {"foo": "bar"}}
{"oid": {"$oid": "56315a7c6118fd1b920270b1"}}
{"dec128": {"$numberDecimal": "1234.5678"}}
{"binary": {"$binary": {"base64": "Zm9v", "subType": "00"}}}
{"date": {"$date": "2015-10-28T00:00:00Z"}}
{"timestamp": {"$timestamp": {"t": 5678, "i": 1234}}}
{"regex": {"$regularExpression": {"pattern": "pattern", "options": "i"}}}
{"code": {"$code": "function() {return 1;}"}}
{"code_ws": {"$code" : "function() {return a;}", "$scope": {"a": 1}}}
{"minkey": {"$minKey": 1}}
{"maxkey": {"$maxKey": 1}}

Смотрите также

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top