MongoCollection::setReadPreference
(PECL mongo >=1.3.0)
MongoCollection::setReadPreference — Définit les préférences de lecture pour cette collection
Description
$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
, ouMongoClient::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 MongoCollection::setReadPreference() avec un jeu de tags sous la forme d'un tableau
<?php $m = new MongoClient(); $c = $m->test->users; // Préfère le serveur le plus proche du centre de données "east", également utilisé pour les rapports // mais utilise un serveur du centre de données "west" en cas d'échec $c->setReadPreference(MongoClient::RP_NEAREST, array( array('dc' => 'east', 'use' => 'reporting'), array('dc' => 'west'), )); ?>
Voir aussi
- La documentation sur les préférences de lecture.