指定 CRUD 在副本集上的运行方式

客户端配置

此示例演示如何通过向构造函数传递大量来设立 MongoDB\Client实例的读取偏好（read preference）、读关注（read concern）和写关注（write concern）。 该代码配置以下设置：

• secondary 读取偏好（read preference）：读取操作从从节点(secondary node from replica set)副本集成员检索数据

• local 读关注（read concern）：读取操作返回实例的最新数据，但不保证该数据已写入大多数副本集成员

• 2 写关注（write concern）：主节点 (primary node in the replica set)和一个从从节点(secondary node from replica set)副本集成员必须确认写入操作

$clientOptions = [
    'readPreference' => 'secondary',
    'readConcernLevel' => 'local',
    'w' => '2',
];
$client = new Client('mongodb://localhost:27017', $clientOptions);

或者，您可以在连接 URI 中指定读取和写入设置，该 URI 作为参数传递给MongoDB\Client构造函数：

$uri = 'mongodb://localhost:27017/?readPreference=secondary&readConcernLevel=local&w=2';
$client = new Client($uri);

会话配置

此示例演示如何通过将大量传递给startSession()方法来设立会话的读取偏好（read preference）、读关注（read concern）和写关注（write concern）。 该代码配置以下设置：

• PRIMARY_PREFERRED 读取偏好（read preference）：读取操作从主节点 (primary node in the replica set)副本集成员检索数据，如果从节点(secondary node from replica set)主节点 (primary node in the replica set)不可用，则从节点成员检索数据

• LOCAL 读关注（read concern）：读取操作返回实例的最新数据，但不保证该数据已写入大多数副本集成员

• MAJORITY 写关注（write concern）：所有副本集成员中的大多数必须确认写入操作

$sessionOptions = [
    'readPreference' => new ReadPreference(ReadPreference::PRIMARY_PREFERRED),
    'readConcern' => new ReadConcern(ReadConcern::LOCAL),
    'writeConcern' => new WriteConcern(WriteConcern::MAJORITY),
];
$session = $client->startSession($sessionOptions);

事务配置

此示例演示如何通过将大量传递给startTransaction()方法来设立ACID 事务的读取偏好（read preference）、读关注（read concern）和写关注（write concern）。 该代码配置以下设置：

• PRIMARY 读取偏好（read preference）：读取操作从主节点 (primary node in the replica set)副本集成员检索数据

• MAJORITY 读关注（read concern）：读取操作返回实例已写入大多数副本集成员的最新数据

• 1 写关注（write concern）：主节点 (primary node in the replica set)副本集成员必须确认写入操作

$transactionOptions = [
    'readPreference' => new ReadPreference(ReadPreference::PRIMARY),
    'readConcern' => new ReadConcern(ReadConcern::MAJORITY),
    'writeConcern' => new WriteConcern(1),
];
$session->startTransaction($transactionOptions);

数据库配置

此示例演示如何通过将选项大量传递给selectDatabase()方法来设立名为test_database的数据库的读取偏好（read preference）、读关注（read concern）和写关注（write concern）。 该代码配置以下设置：

• PRIMARY_PREFERRED 读取偏好（read preference）：读取操作从主节点 (primary node in the replica set)副本集成员检索数据，如果从节点(secondary node from replica set)主节点 (primary node in the replica set)不可用，则从节点成员检索数据

• AVAILABLE 读关注（read concern）：读取操作返回实例的最新数据，但不保证该数据已写入大多数副本集成员

• MAJORITY 写关注（write concern）：所有副本集成员中的大多数必须确认写入操作

$db = $client->selectDatabase('test_database', [
    'readPreference' => new ReadPreference(ReadPreference::PRIMARY_PREFERRED),
    'readConcern' => new ReadConcern(ReadConcern::AVAILABLE),
    'writeConcern' => new WriteConcern(WriteConcern::MAJORITY),
]);

集合配置

此示例演示如何通过将选项大量传递给selectCollection()方法来设置集合test_collection的设立的读取偏好（read preference）、读关注（read concern）和写关注（write concern）。 该代码配置以下设置：

• SECONDARY_PREFERRED 读取偏好（read preference）：读取操作从节点副本集成员检索数据，如果没有可用的从节点，则从从节点(secondary node from replica set)主节点 (primary node in the replica set)成员检索数据

• AVAILABLE 读关注（read concern）：读取操作返回实例的最新数据，但不保证该数据已写入大多数副本集成员

• 0 写关注（write concern）：请求不确认写入操作

$collection = $client->selectCollection('test_database', 'test_collection', [
    'readPreference' => new ReadPreference(ReadPreference::SECONDARY_PREFERRED),
    'readConcern' => new ReadConcern(ReadConcern::AVAILABLE),
    'writeConcern' => new WriteConcern(0),
]);

标签集

MongoDB Server允许您根据您选择的任何条件应用键值标签应用于副本集成员。 然后，您可以使用这些标签来定位一个或多个成员以执行读取操作。

默认， MongoDB PHP库在选择要读取的成员时会忽略标签。 要指示MongoDB PHP库首选某些标记，请将它们作为参数传递给MongoDB\Driver\ReadPreference类构造函数。 然后，设立MongoDB\Driver\ReadPreference对象设置为readPreference数据库选项的值。

假设您连接到一个副本集，其中包含托管在美国多个数据中心的成员。 此代码示例将readPreference选项设置为一个标签集，指示test_database优先按以下顺序从从节点(secondary node from replica set)副本集成员读取：

1. 来自纽约数据中心( ['dc' => 'ny'] ) 的成员

2. 来自旧金山数据中心( ['dc' => 'sf'] ) 的成员

3. 任何从节点(secondary node from replica set)( [] )

$readPreference = new ReadPreference(
    ReadPreference::RP_SECONDARY,
    [
        ['dc' => 'ny'],
        ['dc' => 'sf'],
        [],
    ],
);
$db = $client->selectDatabase(
    'test_database',
    ['readPreference' => $readPreference],
);

LocalThreshold

如果多个副本集成员与您指定的读取偏好（read preference）和标签集匹配， MongoDB PHP库将从根据其网络探测（ping）时间选择的最近的副本集成员中读取。

默认，该库仅使用 ping 时间与最近节点的网络探测（ping）时间在15毫秒以内的节点进行查询。 要在延迟较高的成员之间分配读取，请将选项大量传递给设置localThresholdMS选项的MongoDB\Client构造函数。

以下示例指定了35毫秒的本地阈值：

$options = [
    'replicaSet' => 'repl0',
    'readPreference' => new ReadPreference(ReadPreference::RP_SECONDARY_PREFERRED),
    'localThresholdMS' => 35,
];
$client = new Client('mongodb://localhost:27017', [], $options);

在前面的示例中， MongoDB PHP库在最近成员的网络探测（ping）时间的35毫秒内在匹配成员之间分配读取。