PHP 8.4.0 RC4 available for testing

    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|MongoDB\Driver\WriteConcern|null $options = null): MongoDB\Driver\WriteResult
    final public executeCommand(string $db, MongoDB\Driver\Command $command, array|MongoDB\Driver\ReadPreference|null $options = null): MongoDB\Driver\Cursor
    final public executeQuery(string $namespace, MongoDB\Driver\Query $query, array|MongoDB\Driver\ReadPreference|null $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 votre configuration MongoDB, et quels 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

    Improve This Page

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

    User Contributed Notes 1 note

    up
    8
    mike at eastghost dot com
    6 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
    To Top