[函数]MongoDB\BSON\toCanonicalExtendedJSON()函数—用法及示例

函数名：MongoDB\BSON\toCanonicalExtendedJSON()

函数功能：将MongoDB的BSON文档转换为扩展的JSON格式。

函数参数：无

返回值：返回一个字符串，包含转换后的JSON文档。

适用版本：该函数在MongoDB扩展版本1.2.0及以上可用。

使用示例：

<?php
// 创建一个MongoDB的BSON文档
$document = new MongoDB\BSON\Document([
    'name' => 'John Doe',
    'age' => 30,
    'email' => 'johndoe@example.com'
]);

// 转换为扩展的JSON格式
$json = MongoDB\BSON\toCanonicalExtendedJSON($document);

echo $json;
?>

输出结果：

{
    "$document": {
        "name": "John Doe",
        "age": 30,
        "email": "johndoe@example.com"
    }
}

注意事项：

• 该函数只能用于MongoDB的BSON文档，不能用于普通的JSON文档。
• 转换后的JSON文档中会包含$document字段作为根节点。
• 如果BSON文档中包含特殊字符，如\t、\n等，函数会自动进行转义处理。