PHP 7.4.9 Released!


(PECL mongo >=1.3.0)

MongoClient::setReadPreferenceSet the read preference for this connection

A extensão que define esse método está obsoleta. Alternativamente a extensão MongoDB deve ser utilizada. Não há um equivalente deste método na nova extensão.


public MongoClient::setReadPreference ( string $read_preference [, array $tags ] ) : bool



The read preference mode: MongoClient::RP_PRIMARY, MongoClient::RP_PRIMARY_PREFERRED, MongoClient::RP_SECONDARY, MongoClient::RP_SECONDARY_PREFERRED, ou MongoClient::RP_NEAREST.


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.

Valor Retornado

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.


Exemplo #1 MongoClient::setReadPreference() tag set array syntax example


= new MongoClient();

// Prefer the nearest server in the "east" data center also used for reporting,
// but fall back to a server in the "west" data center
$m->setReadPreference(MongoClient::RP_NEAREST, array(
'dc' => 'east''use' => 'reporting'),
'dc' => 'west'),

Veja Também

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top