PHP Conference Kansai 2025

MongoDB\Driver\Session::startTransaction

(mongodb >=1.5.0)

MongoDB\Driver\Session::startTransactionInicia una transacción

Descripción

final public MongoDB\Driver\Session::startTransaction(?array $options = null): void

Inicia una transacción multi-documento asociada a la sesión. En un momento dado, solo se puede tener una transacción abierta para una sesión. Después de iniciar una transacción, el objeto de sesión debe ser pasado a cada operación a través de la opción "session" (por ejemplo MongoDB\Driver\Manager::executeBulkWrite()) para asociar esta operación a la transacción.

Las transacciones pueden ser confirmadas a través de MongoDB\Driver\Session::commitTransaction(), y anuladas con MongoDB\Driver\Session::abortTransaction(). Las transacciones también se anulan automáticamente cuando la sesión se cierra por la recolección de basura o al llamar explícitamente a MongoDB\Driver\Session::endSession().

Parámetros

options

Las opciones pueden ser pasadas como argumento a este método. Cada elemento de este array de opciones reemplaza la opción correspondiente de la opción "defaultTransactionOptions", si se define al iniciar la sesión con MongoDB\Driver\Manager::startSession().

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

Un asunto de escritura a aplicar a la operación.

Esta opción está disponible en MongoDB 3.2+ y resultará en una excepción en tiempo de ejecución si es especificada para una versión de servidor más antigua.

readPreference MongoDB\Driver\ReadPreference

Una preferencia de lectura a usar para seleccionar un servidor para la operación.

writeConcern MongoDB\Driver\WriteConcern

Un asunto de escritura a aplicar a la operación.

Valores devueltos

No devuelve ningún valor.

Errores/Excepciones

Historial de cambios

Versión Descripción
PECL mongodb 1.6.0

La opción "maxCommitTimeMS" fue añadida.

Ver también

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top