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

A classe MongoDB\Driver\Manager

(mongodb >=1.0.0)

Introdução

A classe MongoDB\Driver\Manager é o principal ponto de entrada para a extensão. É responsável por manter conexões com o MongoDB (seja ele servidor independente, conjunto de réplicas ou cluster fragmentado).

Nenhuma conexão com o MongoDB é feita ao instanciar a classe. Isso significa que o objeto MongoDB\Driver\Manager sempre pode ser construído, mesmo que um ou mais servidores MongoDB estejam inativos.

Qualquer escrita ou consulta pode lançar exceções de conexão, pois as conexões são criadas lentamente. Um servidor MongoDB também pode ficar indisponível durante a vida útil do script. Portanto, é importante que todas as ações no objeto Manager sejam agrupadas em instruções try/catch.

Resumo da classe

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
}

Exemplos

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

A função var_dump() executada em um objeto MongoDB\Driver\Manager irá mostrar vários detalhes sobre o gerenciador do driver que não são normalmente expostas. Isso pode ser útil para depurar como o driver visualiza a configuração do MongoDB e quais opções são usadas.

<?php

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

?>

O exemplo acima produzirá algo semelhante a:

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

Índice