La clase MongoDB\Driver\Manager

(mongodb >=1.0.0)

Introducción

La clase MongoDB\Driver\Manager es el punto de entrada principal a la extensión. Es responsable de mantener las conexiones a MongoDB (ya sea un servidor independiente, un conjunto de réplicas o un clúster particionado).

No se realiza ninguna conexión a MongoDB al instanciar el Manager. Esto significa que el MongoDB\Driver\Manager siempre puede ser construido, incluso si uno o más servidores de MongoDB están caídos.

Cualquier escritura o consulta puede lanzar excepciones de conexión ya que las conexiones se crean de forma perezosa. Un servidor de MongoDB también puede volverse no disponible durante la ejecución del script. Por lo tanto, es importante envolver todas las acciones sobre el Manager en sentencias try/catch.

Sinopsis de la Clase

final class MongoDB\Driver\Manager {

/* Métodos */

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

}

Ejemplos

Ejemplo #1 Ejemplo básico de MongoDB\Driver\Manager::__construct()

Realizar un var_dump() de un MongoDB\Driver\Manager mostrará varios detalles sobre el gestor que normalmente no están expuestos. Esto puede ser útil para depurar cómo el controlador visualiza su configuración de MongoDB y qué opciones se están utilizando.

<?php

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

?>

Resultado del ejemplo anterior es similar a:

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

Tabla de contenidos

MongoDB\Driver\Manager::addSubscriber — Registra un observador de eventos de monitoreo con este manager
MongoDB\Driver\Manager::__construct — Crea un nuevo Manager MongoDB
MongoDB\Driver\Manager::createClientEncryption — Crear un nuevo objeto ClientEncryption
MongoDB\Driver\Manager::executeBulkWrite — Ejecuta una o varias operaciones de escritura
MongoDB\Driver\Manager::executeBulkWriteCommand — Ejecuta operaciones de escritura utilizando el comando bulkWrite
MongoDB\Driver\Manager::executeCommand — Ejecuta un comando de base de datos
MongoDB\Driver\Manager::executeQuery — Ejecuta una consulta de base de datos
MongoDB\Driver\Manager::executeReadCommand — Ejecuta un comando de base de datos que lee
MongoDB\Driver\Manager::executeReadWriteCommand — Ejecuta un comando de base de datos que lee y escribe
MongoDB\Driver\Manager::executeWriteCommand — Ejecuta un comando de base de datos que escribe
MongoDB\Driver\Manager::getEncryptedFieldsMap — Devuelve la opción de cifrado automático encryptedFieldsMap para el Manager
MongoDB\Driver\Manager::getReadConcern — Devuelve el ReadConcern para el Manager
MongoDB\Driver\Manager::getReadPreference — Devuelve el ReadPreference para el Manager
MongoDB\Driver\Manager::getServers — Devolver los servidores a los que está conectado este gestor
MongoDB\Driver\Manager::getWriteConcern — Devuelve el WriteConcern para el Manager
MongoDB\Driver\Manager::removeSubscriber — Elimina un observador de eventos de supervisión de este Manager
MongoDB\Driver\Manager::selectServer — Selecciona un servidor correspondiente a una preferencia de lectura
MongoDB\Driver\Manager::startSession — Inicia una nueva sesión de cliente para ser utilizada con este cliente

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