array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'class.mongodb-driver-manager.php', 1 => 'MongoDB\\Driver\\Manager', 2 => 'La clase 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' => 'es', '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 clase MongoDB\Driver\Manager

(mongodb >=1.0.0)

Introducción

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

Ninguna conexión a MongoDB se establece durante la instanciación del Manager. Esto significa que el MongoDB\Driver\Manager puede ser construido siempre, incluso si uno o más servidores MongoDB están fuera de servicio.

Cualquier escritura o consulta puede lanzar excepciones de conexión ya que las conexiones se crean de manera perezosa. Un servidor MongoDB también puede volverse indisponible durante la vida útil del script. Por lo tanto, es importante que todas las acciones sobre el Manager estén envueltas en instrucciones try/catch.

Sinopsis de la Clase

final class MongoDB\Driver\Manager {
/* Métodos */
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
}

Ejemplos

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

var_dump() un MongoDB\Driver\Manager mostrará diversos detalles sobre el Manager que no están normalmente expuestos. Esto puede ser útil para depurar cómo el controlador ve su configuración 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