PHP - Manual: MongoClient::setReadPreference
2024-12-22
(PECL mongo >=1.3.0)
MongoClient::setReadPreference — 为该连接设置读取选项
This extension that defines this method is deprecated. Instead, the MongoDB extension should be used. There is no equivalent for this method in the new extension.
$read_preference
[, array $tags
] ) : boolread_preference
The read preference mode: MongoClient::RP_PRIMARY
, MongoClient::RP_PRIMARY_PREFERRED
, MongoClient::RP_SECONDARY
, MongoClient::RP_SECONDARY_PREFERRED
, or MongoClient::RP_NEAREST
.
tags
An array of zero or more tag sets, where each tag set is itself an array of criteria used to match tags on replica set members.
Returns TRUE
on success, or FALSE
otherwise.
Emits E_WARNING
if either parameter is invalid, or if one or more tag sets are provided with the MongoClient::RP_PRIMARY
read preference mode.
Example #1 MongoClient::setReadPreference() 标签集数组语法的例子
<?php
$m = new MongoClient();
// 首选最近的 "east" 数据中心的服务器,也用于报告,
// 失败时调用 "west" 数据中心的服务器
$m->setReadPreference(MongoClient::RP_NEAREST, array(
array('dc' => 'east', 'use' => 'reporting'),
array('dc' => 'west'),
));
?>
官方地址:https://www.php.net/manual/en/mongoclient.setreadpreference.php