(No version information available, might only be in SVN)
MongoCursor::setReadPreference — Set the read preference for this query
$read_preference
[, array $tags
] )read_preference
The read preference mode: Mongo::RP_PRIMARY
,
Mongo::RP_PRIMARY_PREFERRED
,
Mongo::RP_SECONDARY
,
Mongo::RP_SECONDARY_PREFERRED
, or
Mongo::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.
Example #1 MongoCursor::setReadPreference() tag set array syntaxexample
<?php
$m = new Mongo();
$cursor = $m->test->users->find();
// Prefer the nearest server in the "east" data center also used for reporting,
// but fall back to a server in the "west" data center
$cursor->setReadPreference(Mongo::RP_NEAREST, array(
array('dc' => 'east', 'use' => 'reporting'),
array('dc' => 'west'),
));