MongoDB\Database::withOptions()

定义

MongoDB\Database::withOptions()

返回一个具有不同选项的数据库对象的副本。

function withOptions(array $options = []): MongoDB\Database

参数

$options : array

指定所需选项的数组。

名称	类型	描述
readConcern	MongoDB\Driver\ReadConcern	数据库操作的默认读取关注点。默认为原始数据库的读取关注点。
readPreference	MongoDB\Driver\ReadPreference	数据库操作的默认读取优先级。默认为原始数据库的读取优先级。
typeMap	array	将 类型映射 应用到游标上，它决定了BSON文档如何转换为PHP值。默认为原始数据库的类型映射。
写关注	MongoDB\Driver\WriteConcern	默认用于数据库操作的写关注。默认为原始数据库的写关注。

返回值

AMongoDB\Database 对象。

错误/异常

MongoDB\Exception\InvalidArgumentException 与参数或选项解析相关的错误。

示例

以下示例使用新的读取偏好复制现有的数据库对象

<?php
$db = (new MongoDB\Client)->test;
$newDb = $db->withOptions([
    'readPreference' => new MongoDB\Driver\ReadPreference('primaryPreferred'),
]);

另请参阅

• MongoDB\Database::__construct()