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 的默认读取偏好。
MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED: 在大多数情况下，操作从主服务器读取，但如果主服务器不可用，则操作从辅助成员读取。
MongoDB\Driver\ReadPreference::RP_SECONDARY: 所有操作都从副本集的辅助成员读取。
MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED: 在大多数情况下，操作从辅助成员读取，但如果辅助成员不可用，则操作从主服务器读取。
MongoDB\Driver\ReadPreference::RP_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.7.0

版本	描述
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::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。