MongoDB\Client::startSession()

在此页面上

定义

参数
Return Values
错误/异常
例子
另请参阅

1.3 版本中的新增功能。

定义

MongoDB\Client::startSession()

启动新的客户端会话以与此客户端一起使用。

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

参数

$options : array: 指定所需选项的数组。请参阅 MongoDB\Driver\Manager::startSession() 扩展文档以获取支持的选项列表。

Return Values

MongoDB\Driver\Session 对象。

错误/异常

MongoDB\ 驱动程序\Exception\InvalidArgumentException 与扩展级别的参数或选项解析相关的错误。

MongoDB\ 驱动程序\Exception\RuntimeException 对于扩展级别的其他错误（例如连接错误）。

例子

以下示例启动一个新会话：

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

而输出将类似如下所示：

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
}

另请参阅

MongoDB\Driver\Manager::startSession()
MongoDB 手册中的因果一致性

后退

selectDatabase()

来年

watch()