MongoDB\Driver\ReadPreference::bsonSerialize()函数—用法及示例

函数名：MongoDB\Driver\ReadPreference::bsonSerialize()

适用版本：MongoDB扩展版本1.3.0及以上

用法：该函数用于将MongoDB\Driver\ReadPreference对象序列化为BSON文档，以便在MongoDB驱动中传输和存储。

示例：

<?php
// 创建一个ReadPreference对象
$readPreference = new MongoDB\Driver\ReadPreference(MongoDB\Driver\ReadPreference::RP_PRIMARY);

// 序列化ReadPreference对象为BSON文档
$serialized = $readPreference->bsonSerialize();

// 打印序列化后的BSON文档
var_dump($serialized);
?>

输出：

object(MongoDB\BSON\Document)#1 (1) {
  ["storage":"ArrayObject":private]=>
  array(1) {
    ["mode"]=>
    string(7) "primary"
  }
}

在上面的示例中，我们首先创建了一个MongoDB\Driver\ReadPreference对象，使用了RP_PRIMARY常量来指定首选读取模式为主节点。然后，我们调用bsonSerialize()方法将该对象序列化为BSON文档。最后，我们打印出序列化后的BSON文档，可以看到它是一个MongoDB\BSON\Document对象，包含了一个名为"mode"的字段，其值为"primary"，表示首选读取模式为主节点。

请注意，该函数只能在MongoDB扩展版本1.3.0及以上的环境中使用。