La classe MongoDB\Driver\Manager

(mongodb >=1.0.0)

Introduction

Le MongoDB\Driver\Manager est le point d'entrée principal de l'extension. Il est responsable de maintenir les connexions à MongoDB (qu'il s'agisse d'un serveur autonome, d'un ensemble de réplicas ou d'un cluster partagé).

Aucune connexion à MongoDB n'est établie lors de l'instanciation du Manager. Cela signifie que la MongoDB\Driver\Manager peut toujours être construit, même si un ou plusieurs serveurs MongoDB sont hors service.

Toute écriture ou requête peut lancer des exceptions de connexion car les connexions sont créées de manière paresseuse. Un serveur MongoDB peut également devenir indisponible pendant la durée de vie du script. Il est donc important que toutes les actions sur le Manager soient enveloppées dans des instructions try/catch.

Synopsis de la classe

final class MongoDB\Driver\Manager {

/* Méthodes */

final public function addSubscriber(MongoDB\Driver\Monitoring\Subscriber $subscriber): void

final public function __construct(?string $uri = null, ?array $uriOptions = null, ?array $driverOptions = null)

final public function createClientEncryption(array $options): MongoDB\Driver\ClientEncryption

final public function executeBulkWrite(string $namespace, MongoDB\Driver\BulkWrite $bulk, ?array $options = null): MongoDB\Driver\WriteResult

final public function executeBulkWriteCommand(MongoDB\Driver\BulkWriteCommand $bulk, ?array $options = null): MongoDB\Driver\BulkWriteCommandResult

final public function executeCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor

final public function executeQuery(string $namespace, MongoDB\Driver\Query $query, ?array $options = null): MongoDB\Driver\Cursor

final public function executeReadCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor

final public function executeReadWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor

final public function executeWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor

final public function getEncryptedFieldsMap(): array|object|null

final public function getReadConcern(): MongoDB\Driver\ReadConcern

final public function getReadPreference(): MongoDB\Driver\ReadPreference

final public function getServers(): array

final public function getWriteConcern(): MongoDB\Driver\WriteConcern

final public function removeSubscriber(MongoDB\Driver\Monitoring\Subscriber $subscriber): void

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

final public function startSession(?array $options = null): MongoDB\Driver\Session

}

Exemples

Exemple #1 Usage basique de MongoDB\Driver\Manager::__construct()

var_dump()er un MongoDB\Driver\Manager affichera divers détails sur le Manager qui ne sont pas normalement exposés. Cela peut être utile pour déboguer comment le pilote voit la configuration MongoDB, et quelles options sont utilisées.

<?php

$manager = new MongoDB\Driver\Manager('mongodb://localhost:27017');
var_dump($manager);

?>

Résultat de l'exemple ci-dessus est similaire à :

object(MongoDB\Driver\Manager)#1 (2) {
  ["uri"]=>
  string(26) "mongodb://127.0.0.1:27017/"
  ["cluster"]=>
  array(0) {
  }
}

Sommaire

MongoDB\Driver\Manager::addSubscriber — Enregistre un observateur d'événements de surveillance avec ce manager
MongoDB\Driver\Manager::__construct — Crée un nouveau Manager MongoDB
MongoDB\Driver\Manager::createClientEncryption — Créer un nouvel objet ClientEncryption
MongoDB\Driver\Manager::executeBulkWrite — Exécute une ou plusieurs opérations d'écriture
MongoDB\Driver\Manager::executeBulkWriteCommand — Exécute les opérations d'écriture en utilisant la commande bulkWrite
MongoDB\Driver\Manager::executeCommand — Exécute une commande de base de données
MongoDB\Driver\Manager::executeQuery — Exécute une requête de base de données
MongoDB\Driver\Manager::executeReadCommand — Exécute une commande de base de données qui lit
MongoDB\Driver\Manager::executeReadWriteCommand — Exécute une commande de base de données qui lit et écrit
MongoDB\Driver\Manager::executeWriteCommand — Exécute une commande de base de données qui écrit
MongoDB\Driver\Manager::getEncryptedFieldsMap — Renvoie l'option de chiffrement automatique encryptedFieldsMap pour le Manager
MongoDB\Driver\Manager::getReadConcern — Renvoie le ReadConcern pour le Manager
MongoDB\Driver\Manager::getReadPreference — Renvoie le ReadPreference pour le Manager
MongoDB\Driver\Manager::getServers — Retourner les serveurs auxquels ce gestionnaire est connecté
MongoDB\Driver\Manager::getWriteConcern — Renvoie le WriteConcern pour le Manager
MongoDB\Driver\Manager::removeSubscriber — Enlève un observateur d'événements de surveillance de ce Manager
MongoDB\Driver\Manager::selectServer — Sélectionne un serveur correspondant à une préférence de lecture
MongoDB\Driver\Manager::startSession — Démarre une nouvelle session client pour être utilisée avec ce client

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

mike at eastghost dot com ¶

7 years ago

According to Mongo, this (i.e., MongoDB\Driver\Manager) is an "entry point" for the extension:

"This class serves as an entry point for the MongoDB PHP Library. It is the preferred class for connecting to a MongoDB server or cluster of servers and acts as a gateway for accessing individual databases and collections. MongoDB\Client is analogous to the driver’s MongoDB\Driver\Manager class, which it composes."

copied from here: https://docs.mongodb.com/php-library/master/reference/class/MongoDBClient/

However, any comparison of the "mongodb" docs here on php.net versus the "mongodb driver" docs on mongo's site shows dramatic and ever-changing differences.

＋add a note