MongoDB\Driver\ReadPreference 类

(mongodb >=1.0.0)

简介

类概要

final class MongoDB\Driver\ReadPreference implements MongoDB\BSON\Serializable, Serializable {

/* 常量 */

const int RP_PRIMARY = 1;

const int RP_PRIMARY_PREFERRED = 5;

const int RP_SECONDARY = 2;

const int RP_SECONDARY_PREFERRED = 6;

const int RP_NEAREST = 10;

const string PRIMARY = primary;

const string PRIMARY_PREFERRED = primaryPreferred;

const string SECONDARY = secondary;

const string SECONDARY_PREFERRED = secondaryPreferred;

const string NEAREST = nearest;

const int NO_MAX_STALENESS = -1;

const int SMALLEST_MAX_STALENESS_SECONDS = 90;

/* 方法 */

final public bsonSerialize(): stdClass

final public __construct(string|int $mode, ?array $tagSets = null, ?array $options = null)

final public getHedge(): ?object

final public getMaxStalenessSeconds(): int

final public getMode(): int

final public getModeString(): string

final public getTagSets(): array

final public serialize(): string

final public unserialize(string $data): void

}

预定义常量

MongoDB\Driver\ReadPreference::RP_PRIMARY: 所有操作都从当前副本集主节点读取。这是 MongoDB 的默认读取偏好。

警告
从扩展版本 1.20.0 开始，此常量已弃用，并将在 2.0 中移除。应用程序应改用MongoDB\Driver\ReadPreference::PRIMARY。
MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED: 在大多数情况下，操作从主节点读取，但如果主节点不可用，则操作从辅助成员读取。

警告
从扩展版本 1.20.0 开始，此常量已弃用，并将在 2.0 中移除。应用程序应改用MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED。
MongoDB\Driver\ReadPreference::RP_SECONDARY: 所有操作都从副本集的辅助成员读取。

警告
从扩展版本 1.20.0 开始，此常量已弃用，并将在 2.0 中移除。应用程序应改用MongoDB\Driver\ReadPreference::SECONDARY。
MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED: 在大多数情况下，操作从辅助成员读取，但如果没有辅助成员可用，则操作从主节点读取。

警告
从扩展版本 1.20.0 开始，此常量已弃用，并将在 2.0 中移除。应用程序应改用MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED。
MongoDB\Driver\ReadPreference::RP_NEAREST: 操作从副本集中网络延迟最小的成员读取，而不考虑成员的类型。

警告
从扩展版本 1.20.0 开始，此常量已弃用，并将在 2.0 中移除。应用程序应改用MongoDB\Driver\ReadPreference::NEAREST。
MongoDB\Driver\ReadPreference::PRIMARY: 所有操作都从当前副本集主节点读取。这是 MongoDB 的默认读取偏好。
MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED: 在大多数情况下，操作从主节点读取，但如果主节点不可用，则操作从辅助成员读取。
MongoDB\Driver\ReadPreference::SECONDARY: 所有操作都从副本集的辅助成员读取。
MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED: 在大多数情况下，操作从辅助成员读取，但如果没有辅助成员可用，则操作从主节点读取。
MongoDB\Driver\ReadPreference::NEAREST: 操作从副本集中网络延迟最小的成员读取，而不考虑成员的类型。
MongoDB\Driver\ReadPreference::NO_MAX_STALENESS: 选项 "maxStalenessSeconds" 的默认值为不指定最大陈旧时间限制，这意味着驱动程序在选择读取操作的目标时不会考虑辅助节点的延迟。
MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS: 选项 "maxStalenessSeconds" 的最小值为 90 秒。驱动程序通过定期检查每个副本集成员的最新写入日期来估算辅助节点的陈旧时间。由于这些检查并不频繁，因此陈旧时间估计比较粗略。因此，驱动程序无法强制执行小于 90 秒的最大陈旧时间值。

变更日志

版本描述

PECL mongodb 1.20.0

版本	描述
PECL mongodb 1.20.0	弃用 `MongoDB\Driver\ReadPreference::RP_PRIMARY`、`MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED`、`MongoDB\Driver\ReadPreference::RP_SECONDARY`、`MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED` 和 `MongoDB\Driver\ReadPreference::RP_NEAREST` 常量。
PECL mongodb 1.7.0	添加 `MongoDB\Driver\ReadPreference::PRIMARY`、`MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED`、`MongoDB\Driver\ReadPreference::SECONDARY`、`MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED` 和 `MongoDB\Driver\ReadPreference::NEAREST` 常量。实现 Serializable。
PECL mongodb 1.2.0	添加 `MongoDB\Driver\ReadPreference::NO_MAX_STALENESS` 和 `MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS` 常量。实现 MongoDB\BSON\Serializable。

弃用 MongoDB\Driver\ReadPreference::RP_PRIMARY、MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED、MongoDB\Driver\ReadPreference::RP_SECONDARY、MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED 和 MongoDB\Driver\ReadPreference::RP_NEAREST 常量。

PECL mongodb 1.7.0