CollectionFind::lockShared

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#

Ejecuta la operación con un BLOQUEO COMPARTIDO

Descripción#

public mysql_xdevapi\CollectionFind::lockShared([int $lock_waiting_option]): mysql_xdevapi\CollectionFind
```php

Permite el compartimiento de documentos entre múltiples transacciones que están bloqueadas en modo compartido.

Otras sesiones pueden leer las filas, pero no pueden modificarlas hasta que su transacción no haya sido validada.

Si una de estas filas ha sido modificada por otra transacción que no ha sido validada, la consulta esperará a que esta transacción termine para poder utilizar los últimos valores.

## Parámetros

`lock_waiting_option`  
Una opción de espera opcional. Por omisión, es `MYSQLX_LOCK_DEFAULT`. Los valores válidos son estas constantes:

- `MYSQLX_LOCK_DEFAULT`

- `MYSQLX_LOCK_NOWAIT`

- `MYSQLX_LOCK_SKIP_LOCKED`

## Valores devueltos

Un objeto CollectionFind que puede ser utilizado para un tratamiento ulterior.

## Ejemplos

Ejemplo de `mysql_xdevapi\CollectionFind::lockShared`

getSchema("addressbook"); $collection = $schema->createCollection("people"); $session->startTransaction(); $result = $collection ->find("age > 50") ->lockShared() ->execute(); // ... leer el objeto en modo compartido // Validar la transacción y desbloquear el documento $session->commit(); ?>

```php