MongoDB\BSON\toJSON

    (mongodb >=1.0.0)

    MongoDB\BSON\toJSON — Возвращает Legacy Extended JSON-представление значения BSON

    Описание

    MongoDB\BSON\toJSON(string$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 } }

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

    To Top