pg_lo_export

pg_lo_export([PgSql\Connection $connection], int $oid, string $filename): bool
```php

`pg_lo_export` toma un objeto grande de la base de datos PostgreSQL y guarda su contenido en un fichero local en el sistema.

Para utilizar un objeto grande (`lo`), es necesario hacerlo dentro de una transacción.

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

## 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 grande en la base de datos.

`filename`  
La ruta de acceso completa y el fichero en el que se escribirá el objeto grande en el sistema del cliente.

## Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

## Historial de cambios

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

## Ejemplos

Ejemplo con `pg_lo_export`