Php/docs/mongodb-driver-manager.startsession

来自菜鸟教程
跳转至:导航、​搜索

MongoDB\Driver\Manager::startSession

(mongodb >=1.4.0)

MongoDB\Driver\Manager::startSessionStart a new client session for use with this client


说明

final public MongoDB\Driver\Manager::startSession ([ array $options ] ) : MongoDB\Driver\Session

Creates a MongoDB\Driver\Session for the given options. The session may then be specified when executing commands, queries, and write operations.

Note:

A MongoDB\Driver\Session can only be used with the MongoDB\Driver\Manager from which it was created.

参数

options
{| |+ options !width="25%"| Option !width="25%"| Type !width="25%"| Description !width="25%"| Default |- | causalConsistency | bool |

Configure causal consistency in a session. If true, each operation in the session will be causally ordered after the previous read or write operation. Set to false to disable causal consistency.

See » Casual Consistency in the MongoDB manual for more information.

| true |- | defaultTransactionOptions | array |

Default options to apply to newly created transactions. These options are used unless they are overridden when a transaction is started with different value for each option.

options
Option Type Description
maxCommitTimeMS integer

The maximum amount of time in milliseconds to allow a single commitTransaction command to run.

If specified, maxCommitTimeMS must be a signed 32-bit integer greater than or equal to zero.

readConcern MongoDB\Driver\ReadConcern

A read concern to apply to the operation.

This option is available in MongoDB 3.2+ and will result in an exception at execution time if specified for an older server version.

readPreference MongoDB\Driver\ReadPreference

A read preference to use for selecting a server for the operation.

writeConcern MongoDB\Driver\WriteConcern

A write concern to apply to the operation.

This option is available in MongoDB 4.0+.

| [] |}


返回值

Returns a MongoDB\Driver\Session.


错误/异常


更新日志

版本 说明
PECL mongodb 1.6.0 The "maxCommitTimeMS" option was added to

"defaultTransactionOptions".

PECL mongodb 1.5.0 The "defaultTransactionOptions" option was added.


参见