MongoCollection::save
MongoCollection::setSlaveOkay
MongoCollection
PHP Manual

# MongoCollection::setReadPreference

(PECL mongo >=1.3.0)

MongoCollection::setReadPreference — Set the read preference for this collection

### Descrição

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

### Parâmetros

`read_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.

### Valor Retornado

Returns `TRUE` on success, or `FALSE` otherwise.

### Erros

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.

### Exemplos

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

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

### Veja Também

- The read preferences documentation.

MongoCollection::save
MongoCollection::setSlaveOkay
MongoCollection
PHP Manual