このデータベースの優先読み込みを設定する

# MongoDB::setReadPreference

(PECL mongo >=1.3.0)

MongoDB::setReadPreference — このデータベースの優先読み込みを設定する

### 説明

public MongoDB::setReadPreference ( string `$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` を返します。

### エラー / 例外

パラメータが無効な場合、あるいは優先読み込みモードが `MongoClient::RP_PRIMARY` のときにタグセットを指定した場合に `E_WARNING` が発生します。

### 例

例1 MongoDB::setReadPreference() タグセット配列構文の例

`<?php
$m = new MongoClient();
$db = $m->test;
// "east" データセンターの一番近いサーバーをレポート用に使うようにして、
// 代替として "west" データセンターのサーバーを設定します
$db->setReadPreference(MongoClient::RP_NEAREST, array(
array('dc' => 'east', 'use' => 'reporting'),
array('dc' => 'west'),
));
?>`

### 参考

- 優先読み込みのドキュメント
- MongoDB::getReadPreference() - このデータベースの優先読み込みを取得する