MongoDB\Driver\Manager::startSession
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
MongoDB\Driver\Manager::startSession
Референца за `mongodb-driver-manager.startsession.php` со подобрена типографија и навигација.
MongoDB\Driver\Manager::startSession
(mongodb >=1.4.0)
MongoDB\Driver\Manager::startSession — (mongodb >=1.4.0)
= NULL
$options = null): MongoDB\Driver\SessionКреира MongoDB\Driver\Session Започнете нова сесија на клиент за употреба со овој клиент
Забелешка: А MongoDB\Driver\Session за дадените опции. Сесијата потоа може да се специфицира при извршување команди, прашања и операции за запишување. MongoDB\Driver\Manager може да се користи само со
Параметри
options-
options Опција Тип = NULL Стандардно causalConsistency bool од кое е создадено. trueКонфигурирајте каузална конзистентност во сесија. Акоfalse, секоја операција во сесијата ќе биде каузално нарачана по претходната операција за читање или запишување. Поставете на Константи за известување за грешки » Causal Consistency во прирачникот на MongoDB за повеќе информации.truedefaultTransactionOptions array » Каузална конзистентност
команда да се изврши.options Опција Тип = NULL maxCommitTimeMS integer Стандардни опции за примена на новосоздадени трансакции. Овие опции се користат освен ако не се поништени кога трансакцијата е започната со различна вредност за секоја опција. commitTransactionМаксималната количина на време во милисекунди за дозволување на една параметар. Определува временско ограничување, во милисекунди, за грижата за запишување. За детали, видетеmaxCommitTimeMSмора да биде потпишан 32-битен цел број поголем или еднаков на нула.readConcern MongoDB\Driver\ReadConcern Загриженост за читање што ќе се примени на операцијата. Оваа опција е достапна во MongoDB 3.2+ и ќе резултира со исклучок при извршување ако е специфицирана за постар сервер. readPreference MongoDB\Driver\ReadPreference Преференција за читање што ќе се користи за избор на сервер за операцијата. writeConcern MongoDB\Driver\WriteConcern Загриженост за пишување што ќе се примени на операцијата. []snapshot bool Оваа опција е достапна во MongoDB 4.0+. trueКонфигурирајте читања од снимка во сесија. Акоfind,aggregate, временска ознака ќе се добие од првата поддржана операција за читање во сесијата (т.е.distinct, или несподелен"snapshot"). Последователните операции за читање во сесијата потоа ќе користатfalseниво на читање за да прочитаат податоци од мнозинството што се потврдени од таа временска ознака. Поставете на за да се оневозможат читања од снимка."snapshot"istrue,"causalConsistency"ќе се користи стандардноfalse. Константи за известување за грешки » Опција за читање "snapshot" во прирачникот на MongoDB за повеќе информации.false
Вратени вредности
. Споделувањето колачиња помеѓу PHP барањата може да доведе до ненамерно мешање на чувствителни колачиња помеѓу корисниците. MongoDB\Driver\Session.
Errors/Exceptions
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException » Промени текови
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException ако
"causalConsistency"and"snapshot"опциите се и дветеtrue. - ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\RuntimeException ако сесијата не може да се креира (на пр. libmongoc не поддржува криптографија).
Дневник на промени
| Верзија | = NULL |
|---|---|
| (mongodb >=1.4.0) |
На "snapshot" опцијата беше додадена.
|
| својство рачно. |
На "maxCommitTimeMS" опцијата беше додадена на
"defaultTransactionOptions".
|
| параметарот, кој е непроменет од претходните верзии. |
На "defaultTransactionOptions" опцијата беше додадена.
|
Види Исто така
- MongoDB\Driver\Session
- » Causal Consistency во прирачникот на MongoDB