Exporta un objeto grande a un fichero

# pg_lo_export

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_lo_export — Exporta un objeto grande a un fichero

### Descripción

function pg_lo_export(PgSql\Connection `$connection` = ?, int `$oid`, string `$filename`): bool

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.

> Nota:

> Anteriormente, esta función se llamaba pg_loexport().

### Parámetros

`connection`

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

  Advertencia

  Desde PHP 8.1.0, usar la conexión por defecto 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 #1 Ejemplo con pg_lo_export()

    <?php
       $database = pg_connect("dbname=jacarta");
       pg_query($database, "begin");
       $oid = pg_lo_create($database);
       $handle = pg_lo_open($database, $oid, "w");
       pg_lo_write($handle, "datos objeto grande");
       pg_lo_close($handle);
       pg_lo_export($database, $oid, '/tmp/lob.dat');
       pg_query($database, "commit");
    ?>

### Ver también

- pg_lo_import() - Importa un objeto grande desde un fichero

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open