Documentación offline PHP master

MongoDB\BSON\Document::toCanonicalExtendedJSON

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

MongoDB\BSON\Document::toCanonicalExtendedJSON

Devuelve la representación Canónica Extendida JSON del documento BSON

Descripción#

final public MongoDB\BSON\Document::toCanonicalExtendedJSON(): string
```php

Convierte el documento BSON en su representación [Canónica Extendida JSON](https://github.com/mongodb/specifications/blob/master/source/extended-json/extended-json.md#canonical-extended-json-example). El formato canónico prefiere la fidelidad de los tipos a la salida concisa y es el más adecuado para producir una salida que puede ser convertida en BSON sin pérdida de información de tipo (por ejemplo, los tipos numéricos permanecerán diferenciados).

## Parámetros

Esta función no contiene ningún parámetro.

## Valores devueltos

Devuelve un string que contiene la [representación Canonical Extended JSON](https://github.com/mongodb/specifications/blob/master/source/extended-json/extended-json.md#canonical-extended-json-example) del documento BSON.

## Ejemplos

Ejemplo de MongoDB\BSON\Document::toCanonicalExtendedJSON
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\Document::fromPHP($document); echo $bson->toCanonicalExtendedJSON(), "\n"; } ?>

```php

El ejemplo anterior mostrará:

{ "null" : null }
{ "boolean" : true }
{ "string" : "foo" }
{ "int32" : { "$numberInt" : "123" } }
{ "int64" : { "$numberLong" : "4294967295"} }
{ "double" : { "$numberDouble" : "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" : { "$numberLong" : "1445990400000" } } }
{ "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" : { "$numberInt" : "1" } } } }
{ "minkey" : { "$minKey" : 1 } }
{ "maxkey" : { "$maxKey" : 1 } }

Véase también#

MongoDB\BSON\Document::fromJSON

MongoDB\BSON\Document::toRelaxedExtendedJSON

MongoDB\BSON\toCanonicalExtendedJSON

Canónica Extendida JSON

Tipos BSON