MongoDB\Driver\Manager::selectServer

(mongodb >=1.0.0)

MongoDB\Driver\Manager::selectServer — SĂ©lectionne un serveur correspondant Ă  une prĂ©fĂ©rence de lecture

Description

final public function MongoDB\Driver\Manager::selectServer(?MongoDB\Driver\ReadPreference $readPreference = null): MongoDB\Driver\Server

SĂ©lectionne un MongoDB\Driver\Server correspondant Ă  readPreference. Si readPreference est null ou omis, le serveur primaire sera sĂ©lectionnĂ© par dĂ©faut. Cela peut ĂȘtre utilisĂ© pour prĂ©-sĂ©lectionner un serveur afin d'effectuer une vĂ©rification de version avant d'exĂ©cuter une opĂ©ration.

Note: Contrairement à MongoDB\Driver\Manager::getServers(), cette méthode initialisera les connexions de base de données et effectuera la découverte de serveurs si nécessaire. Voir la » Spécification de sélection de serveur pour plus d'informations.

Liste de paramĂštres

readPreference (MongoDB\Driver\ReadPreference)
Les préférences de lecture à utiliser pour sélectionner un serveur. Si null ou omis, le serveur primaire sera sélectionné par défaut.

Valeurs de retour

Renvoie un MongoDB\Driver\Server correspondant à la préférence de lecture.

Erreurs / Exceptions

  • Lance une exception MongoDB\Driver\AuthenticationException si une identification est nĂ©cessaire mais qu'elle Ă©choue
  • Lance une exception MongoDB\Driver\ConnectionException si la connexion au serveur Ă©choue pour une autre raison qu'en raison d'un problĂšme d'identification
  • Lance une MongoDB\Driver\Exception\RuntimeException si un serveur correspondant Ă  la prĂ©fĂ©rence de lecture n'a pas pu ĂȘtre trouvĂ©.

Historique

Version Description
PECL mongodb 1.11.0 Le readPreference est maintenant optionnel. Si null ou omis, le serveur primaire sera sélectionné par défaut.

Voir aussi

Found A Problem?

Learn How To Improve This Page ‱ Submit a Pull Request ‱ Report a Bug
add a note

User Contributed Notes

There are no user contributed notes for this page.