(mongodb >=1.0.0)
MongoDB\BSON\toJSON — 傳回 BSON 值的舊版擴展 JSON 表示法
此函式自擴充版本 1.20.0 起已遭棄用,並將於 2.0 中移除。應用程式應改用 MongoDB\BSON\Document::toCanonicalExtendedJSON() 或 MongoDB\BSON\Document::toRelaxedExtendedJSON()。
將 BSON 字串轉換為其 » 舊版擴展 JSON 表示法。
注意:表示 BSON 的 JSON 格式有好幾種。此函數實作 » MongoDB 擴展 JSON 中定義的「嚴格模式」,該模式已被 » 擴展 JSON 規範 中定義的標準格式和寬鬆格式取代,並分別由 MongoDB\BSON\toCanonicalExtendedJSON() 和 MongoDB\BSON\toRelaxedExtendedJSON() 實作。
» JSON 不支援 NAN
和 INF
,而 MongoDB 的舊版擴展 JSON 格式並未定義這些值的替代表示法(» libbson 會輸出 nan
和 inf
字面值,這些字面值可能無法被解析為有效的 JSON)。如果您正在處理可能包含非有限數字的 BSON,請使用 MongoDB\BSON\toCanonicalExtendedJSON() 或 MongoDB\BSON\toRelaxedExtendedJSON()。
bson
(字串)要轉換的 BSON 值。
轉換後的 JSON 值。
範例 #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 } }