PHP.mk документација

MongoDB\Driver\ReadPreference::__construct

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

mongodb-driver-readpreference.construct.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека mongodb-driver-readpreference.construct.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
Референца
MongoDB\Driver\ReadPreference::__construct

Референца за `mongodb-driver-readpreference.construct.php` со подобрена типографија и навигација.

mongodb-driver-readpreference.construct.php

MongoDB\Driver\ReadPreference::__construct

класата MongoDB\Driver\BulkWrite

MongoDB\Driver\ReadPreference::__construct — Креирај нова ReadPreference

= NULL

final public function MongoDB\Driver\ReadPreference::__construct(string $mode, ?array $tagSets = null, ?array $options = null)

(PHP 5, PHP 7, PHP 8, PECL tidy >= 0.5.2) MongoDB\Driver\ReadPreference, што е непроменлив објект со вредност.

Параметри

mode

Креирај нова ReadPreference
Име (константа) = NULL
"primary" Сите операции читаат од моменталниот примарен член на репликацијата. Ова е стандардната преференција за читање за MongoDB.
"primaryPreferred" Во повеќето ситуации, операциите читаат од примарниот член, но ако тој не е достапен, операциите читаат од секундарните членови.
"secondary" Сите операции читаат од секундарните членови на репликацијата.
"secondaryPreferred" Во повеќето ситуации, операциите читаат од секундарните членови, но ако нема достапни секундарни членови, операциите читаат од примарниот член.
"nearest" Операциите читаат од член на репликацијата со најмала мрежна латентност, без оглед на типот на членот.
tagSets
Режим на претпочитање за читањеarray()Поставките за ознаки овозможуваат насочување на операциите за читање кон специфични членови на реплика сет. Овој параметар треба да биде низа од асоцијативни низи, од кои секоја содржи нула или повеќе парови клуч/вредност. При избирање на сервер за операција за читање, драјверот се обидува да избере јазол што ги има сите ознаки во една поставка (т.е. асоцијативната низа од парови клуч/вредност). Ако изборот не успее, драјверот ќе се обиде со следните поставки. Празен сет на ознаки (",") ќе одговара на кој било јазол и може да се користи како резервна опција. Ознаките не се компатибилни со "primary" режимот и, генерално, се применуваат само при избирање на секундарен член на сет за операција за читање. Сепак, "nearest" режимот, кога е комбиниран со сет на ознаки, го избира соодветниот член со најниска мрежна латентност. Овој член може да биде примарен или секундарен.
options

options
Опција Тип = NULL
hedge object|array Определува дали да се користи » прочитани со хеџирање, што е поддржано од MongoDB 4.4+ за шардирани прашања. Читањата со хеџирање на серверот се достапни за сите претпочитања за читање што не се примарни и се овозможени по дифолт кога се користи "nearest" режимот. Оваа опција експлицитно овозможува читања со хеџирање на серверот за претпочитања за читање што не се примарни со специфицирање ['enabled' => true], "nearest" или експлицитно оневозможува читања со хеџирање на серверот за ['enabled' => false].
maxStalenessSeconds int претпочитање за читање со специфицирање Ако е специфицирано, максималната застареност мора да биде потпишан 32-битен цел број поголем или еднаков на MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS. Стандардно е MongoDB\Driver\ReadPreference::NO_MAX_STALENESSОпределува максимално заостанување на репликацијата, или „застареност“, за читања од секундарни. Кога проценетата застареност на секундарниот ќе ја надмине оваа вредност, драјверот престанува да го користи за операции за читање. , "primary" што значи дека драјверот нема да го земе предвид заостанувањето на секундарниот при изборот каде да насочи операција за читање.

Errors/Exceptions

  • ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException » Промени текови
  • ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException if mode е невалидна. Пред PHP 8.4.0, невалиден режим би се прифатил тивко како
  • ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException if tagSets Оваа опција не е компатибилна со
  • ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException ако "maxStalenessSeconds" режимот. Специфицирањето максимална застареност, исто така, бара сите MongoDB инстанци во распоредувањето да користат MongoDB 3.4+. Ќе биде фрлен исклучок при извршување ако некоја од MongoDB инстанците во распоредувањето е од постара верзија на серверот.

Дневник на промени

Верзија = NULL
(mongodb >=1.3.0) Поминување на int » PEAR mode аргументот веќе не се поддржува.
= nearest Поминување на int » PEAR mode аргументот е DEPRECATED.
PECL mongodb 1.8.0 Додаден е "hedge" option.
за PHP 8.0+. На mode аргументот сега прифаќа вредност од тип стринг, што е конзистентно со "readPreference" опцијата URI за Секое пишување или барање може да фрли исклучоци за поврзување бидејќи врските се создаваат мрзливо. MongoDB сервер може исто така да стане недостапен за време на животниот век на скриптата. Затоа е важно сите дејства на Менаџерот да бидат завиткани во try/catch изјави..
PECL mongodb 1.3.0 Додадено е трето options Додаден е втор "maxStalenessSeconds" option.

Примери

Пример #1 MongoDB\Driver\ReadPreference::__construct() example

<?php

/* Prefer a secondary node but fall back to a primary. */
var_dump(new MongoDB\Driver\ReadPreference(MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED));

/* Prefer a node in the New York data center with lowest latency. */
var_dump(new MongoDB\Driver\ReadPreference(MongoDB\Driver\ReadPreference::NEAREST, [['dc' => 'ny']]));

/* Require a secondary node whose replication lag is within two minutes of the primary */
var_dump(new MongoDB\Driver\ReadPreference(MongoDB\Driver\ReadPreference::SECONDARY, null, ['maxStalenessSeconds' => 120]));

/* Explicitly enable server hedged reads */
var_dump(new MongoDB\Driver\ReadPreference(MongoDB\Driver\ReadPreference::SECONDARY, null, ['hedge' => ['enabled' => true]]));

?>

Пример #1 Пример што покажува затворачка ознака што го опфаќа последниот нов ред

object(MongoDB\Driver\ReadPreference)#1 (1) {
  ["mode"]=>
  string(18) "secondaryPreferred"
}
object(MongoDB\Driver\ReadPreference)#1 (2) {
  ["mode"]=>
  string(7) "nearest"
  ["tags"]=>
  array(1) {
    [0]=>
    object(stdClass)#2 (1) {
      ["dc"]=>
      string(2) "ny"
    }
  }
}
object(MongoDB\Driver\ReadPreference)#1 (2) {
  ["mode"]=>
  string(9) "secondary"
  ["maxStalenessSeconds"]=>
  int(120)
}
object(MongoDB\Driver\ReadPreference)#1 (2) {
  ["mode"]=>
  string(9) "secondary"
  ["hedge"]=>
  object(stdClass)#1 (1) {
    ["enabled"]=>
    bool(true)
  }
}

Белешки од корисници

Нема белешки од корисници за оваа страница.
Навигација

Прелистувај сродни теми и функции.

На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.
PHP.mk документација

PHP.mk интерфејс

Македонска PHP документација со читлив интерфејс, белешки и прегледна навигација.

Отвори документација
HTTP сервиси

PHP.mk интерфејс

Scrape, IP2Geo, Open Graph и Feed2JSON се достапни во истиот прегледен интерфејс.

Каталог на сервиси
Регистрирај домен

PHP.mk интерфејс

Провери слободен поддомен без најава, а регистрацијата продолжи ја по LoginJet најава.

Провери домен
PHP.mk · 2026 · Македонска PHP документација со локален интерфејс.