array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'class.mongodb-driver-readpreference.php', 1 => 'MongoDB\\Driver\\ReadPreference', 2 => 'Класс MongoDB\\Driver\\ReadPreference', ), 'up' => array ( 0 => 'mongodb.mongodb.php', 1 => 'MongoDB\\Driver', ), 'prev' => array ( 0 => 'mongodb-driver-writeconcern.isdefault.php', 1 => 'MongoDB\\Driver\\WriteConcern::isDefault', ), 'next' => array ( 0 => 'mongodb-driver-readpreference.bsonserialize.php', 1 => 'MongoDB\\Driver\\ReadPreference::bsonSerialize', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/mongodb/mongodb/driver/readpreference.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.mongodb-driver-readpreference.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Класс MongoDB\Driver\ReadPreference

(mongodb >=1.0.0)

Введение

Обзор класса

final class MongoDB\Driver\ReadPreference implements MongoDB\BSON\Serializable, Serializable {
/* Константы */
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 $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
}

Предопределённые константы

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" чтобы указать на ограничение на максимальное запаздывание (staleness), что означает, что драйвер не будет учитывать задержку вторичных узлов при выборе направления для операции чтения.

MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS

Минимальное значение для параметра "maxStalenessSeconds" равно 90 секундам. Драйвер оценивает запаздывание (staleness) вторичных узлов, периодически проверяя последнюю дату записи каждого члена набора реплик. Поскольку эти проверки нечастые, оценка запаздывания грубая. Поэтому драйвер не обеспечивает максимальную величину запаздывания меньше 90 секунд.

Список изменений

Версия Описание
PECL-модуль mongodb 2.0.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. Метод getMode() тоже удалили.

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.

Содержание