MongoDB\Client::startSession()

Definição

MongoDB\Client::startSession()

Inicie uma nova sessão de cliente para usar com este cliente.

function startSession(array $options = []): MongoDB\Driver\Session

Parâmetros

$options : array

Um array especificando as opções desejadas. Consulte o MongoDB\Driver\Manager::startSession() documentação de extensão para uma lista de opções suportadas.

Return Values

Um MongoDB\Driver\Session evento.

Erros/exceções

MongoDB\Driver\Exception\InvalidArgumentException para erros relacionados à análise de parâmetros ou opções no nível da extensão.

MongoDB\Driver\Exception\RuntimeException para outros erros no nível da extensão (por exemplo erros de conexão).

Exemplo

O exemplo a seguir inicia uma nova sessão:

<?php
$client = new MongoDB\Client;
$session = $client->startSession();
var_dump($session);

A saída seria então semelhante a:

object(MongoDB\Driver\Session)#2043 (4) {
  ["logicalSessionId"]=>
  array(1) {
    ["id"]=>
    object(MongoDB\BSON\Binary)#225 (2) {
      ["data"]=>
      string(16) "................"
      ["type"]=>
      int(4)
    }
  }
  ["clusterTime"]=>
  NULL
  ["causalConsistency"]=>
  bool(true)
  ["operationTime"]=>
  NULL
}

Veja também

• MongoDB\Driver\Manager::startSession()

• Consistência causal no Manual do MongoDB