array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'class.mongodb-driver-manager.php', 1 => 'MongoDB\\Driver\\Manager', 2 => 'La classe MongoDB\\Driver\\Manager', ), 'up' => array ( 0 => 'mongodb.mongodb.php', 1 => 'MongoDB\\Driver', ), 'prev' => array ( 0 => 'mongodb.mongodb.php', 1 => 'MongoDB\\Driver', ), 'next' => array ( 0 => 'mongodb-driver-manager.addsubscriber.php', 1 => 'MongoDB\\Driver\\Manager::addSubscriber', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/mongodb/mongodb/driver/manager.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.mongodb-driver-manager.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 addSubscriber(MongoDB\Driver\Monitoring\Subscriber $subscriber): void
final public __construct(?string $uri = null, ?array $uriOptions = null, ?array $driverOptions = null)
final public createClientEncryption(array $options): MongoDB\Driver\ClientEncryption
final public executeBulkWrite(string $namespace, MongoDB\Driver\BulkWrite $bulk, ?array $options = null): MongoDB\Driver\WriteResult
final public executeBulkWriteCommand(MongoDB\Driver\BulkWriteCommand $bulk, ?array $options = null): MongoDB\Driver\BulkWriteCommandResult
final public executeCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
final public executeQuery(string $namespace, MongoDB\Driver\Query $query, ?array $options = null): MongoDB\Driver\Cursor
final public executeReadCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
final public executeReadWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
final public executeWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
final public getEncryptedFieldsMap(): array|object|null
final public getReadConcern(): MongoDB\Driver\ReadConcern
final public getReadPreference(): MongoDB\Driver\ReadPreference
final public getServers(): array
final public getWriteConcern(): MongoDB\Driver\WriteConcern
final public removeSubscriber(MongoDB\Driver\Monitoring\Subscriber $subscriber): void
final public selectServer(?MongoDB\Driver\ReadPreference $readPreference = null): MongoDB\Driver\Server
final public 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