MongoDB\Client::startSession()

Definición

MongoDB\Client::startSession()

Inicia una nueva sesión de cliente para uso con este cliente.

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

Parámetros

$options : arreglo

Un arreglo que especifica las opciones deseadas. Remítase a la MongoDB\Driver\Manager::startSession() documentación de extensión para ver una lista de las opciones admitidas.

Return Values

Un objeto MongoDB\Driver\Session.

Errores/Excepciones

MongoDB\Driver\Exception\InvalidArgumentException para errores relacionados con el análisis de parámetros u opciones en el nivel de extensión.

MongoDB\Driver\Exception\RuntimeException para otros errores en el nivel de extensión (por ejemplo, errores de conexión).

Ejemplo

El siguiente ejemplo inicia una nueva sesión:

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

La vista de salida se ilustraría como sigue:

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
}

Ver también

• MongoDB\Driver\Manager::startSession()

• Consistencia causal en el manual de MongoDB