MongoCursor::setReadPreference

(PECL mongo >=1.3.3)

MongoCursor::setReadPreferenceDéfinit les préférences de lecture pour cette requête

Description

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

Liste de paramètres

read_preference

Le mode de préférence de lecture : MongoClient::RP_PRIMARY, MongoClient::RP_PRIMARY_PREFERRED, MongoClient::RP_SECONDARY, MongoClient::RP_SECONDARY_PREFERRED, ou MongoClient::RP_NEAREST.

tags

Un tableau de zéro ou plusieurs jeux de tags, où chaque jeu de tags est lui même un tableau de critères utilisés pour faire correspondre les tags sur les membres du jeu de réplication.

Valeurs de retour

Retourne TRUE en cas de succès, ou FALSE sinon.

Erreurs / Exceptions

Emets une alerte de niveau E_WARNING si soit le paramètre est invalide, soit si un ou plusieurs jeux de tags sont fournis avec le mode de préférence de lecture MongoClient::RP_PRIMARY.

Exemples

Exemple #1 Exemple avec MongoCursor::setReadPreference()

<?php

$m = new MongoClient();
$cursor = $m->test->users->find();

// Préfère le serveur le plus proche dans le centre de données "east", également
// utilisé pour les rapports, mais utilise un serveur du centre de données "west"
// en cas d'échec
$cursor->setReadPreference(MongoClient::RP_NEAREST, array(
	array('dc' => 'east', 'use' => 'reporting'),
	array('dc' => 'west'),
));
?>

Voir aussi

LoadingChargement en cours