MongoClient::setReadPreference
(PECL mongo >=1.3.0)
MongoClient::setReadPreference — Устанавливает предпочтения чтения для соединения
Расширение, задающее этот метод, объявлено устаревшим. Вместо него используйте расширение MongoDB. Никакой замены данному методу не предусмотрено.
Описание
$read_preference
, array $tags
= ?
) : boolСписок параметров
-
read_preference
-
Режимы предпочтения чтения:
MongoClient::RP_PRIMARY
,MongoClient::RP_PRIMARY_PREFERRED
,MongoClient::RP_SECONDARY
,MongoClient::RP_SECONDARY_PREFERRED
иMongoClient::RP_NEAREST
. -
tags
-
Пустой массив, либо содержащий наборы тегов, где каждый такой набор является массивом из критериев, используемых в соответствии с тегами членов набора реплик.
Возвращаемые значения
Возвращает true
в случае успеха, иначе - false
.
Ошибки
Генерирует ошибку уровня E_WARNING
, в случае неверных параметров, либо если один или более наборов тегов были переданы с режимом чтения MongoClient::RP_PRIMARY
.
Примеры
Пример #1 Пример синтаксиса массива набора тегов MongoClient::setReadPreference()
<?php
$m = new MongoClient();
// Предпочитаем ближайший сервер в "восточном" дата-центре, также используемый для отчетности,
// но используем сервер в "западном" дата-центре
$m->setReadPreference(MongoClient::RP_NEAREST, array(
array('dc' => 'east', 'use' => 'reporting'),
array('dc' => 'west'),
));
?>
Смотрите также
- Документация по предпочтениям чтения.
- MongoClient::getReadPreference() - Получает предпочтения чтения для соединения