PHP Conference Japan 2024

MongoDB\BSON\toJSON

(mongodb >=1.0.0)

MongoDB\BSON\toJSON傳回 BSON 值的舊版擴展 JSON 表示法

警告

此函式自擴充版本 1.20.0 起已遭棄用,並將於 2.0 中移除。應用程式應改用 MongoDB\BSON\Document::toCanonicalExtendedJSON()MongoDB\BSON\Document::toRelaxedExtendedJSON()

說明

MongoDB\BSON\toJSON(字串 $bson): 字串

將 BSON 字串轉換為其 » 舊版擴展 JSON 表示法。

注意表示 BSON 的 JSON 格式有好幾種。此函數實作 » MongoDB 擴展 JSON 中定義的「嚴格模式」,該模式已被 » 擴展 JSON 規範 中定義的標準格式和寬鬆格式取代,並分別由 MongoDB\BSON\toCanonicalExtendedJSON()MongoDB\BSON\toRelaxedExtendedJSON() 實作。

警告

» JSON 不支援 NANINF,而 MongoDB 的舊版擴展 JSON 格式並未定義這些值的替代表示法(» libbson 會輸出 naninf 字面值,這些字面值可能無法被解析為有效的 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 } }

另請參閱

新增註解

使用者貢獻的註解

此頁面沒有使用者貢獻的註解。
To Top