pg_lo_open

pg_lo_open(PgSql\Connection $connection, int $oid, string $mode): PgSql\Lob
```php

`pg_lo_open` abre un objeto grande en la base de datos y devuelve una instancia de `PgSql\Lob` para que pueda ser manipulado.

> [!WARNING]
> No cerrar la conexión a la base de datos antes de cerrar la instancia `PgSql\Lob`.

Para utilizar un objeto de gran tamaño (`lo`), es necesario hacerlo dentro de una transacción.

> [!NOTE]
> Anteriormente, esta función se llamaba `pg_loopen`.

## Parámetros

`connection`  
Una `PgSql\Connection` instancia. Cuando `connection` no es especificado, se usa la conexión por defecto. La conexión predeterminada es la última conexión hecha por `pg_connect` o `pg_pconnect`

> [!WARNING]
> Desde PHP 8.1.0, usar la conexión predeterminada está obsoleto.

`oid`  
El `OID` del objeto de gran tamaño en la base de datos.

`mode`  
Puede ser "r" para solo lectura, "w" para solo escritura o "rw" para lectura y escritura.

## Valores devueltos

Una instancia `PgSql\Lob`, o `false` si ocurre un error.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | Ahora devuelve una instancia de `PgSql\Lob`; anteriormente, se devolvía un `resource`. |
| 8.1.0 | El parámetro `connection` ahora espera una instancia de `PgSql\Connection` ; anteriormente, se esperaba un `resource`. |

## Ejemplos

Ejemplo con `pg_lo_open`