pg_lo_import

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

pg_lo_import Importa un objeto de gran tamaño desde un fichero

Descripción

pg_lo_import(PgSql\Connection $connection = ?, string $pathname, mixed $object_id = ?): int|string|false

pg_lo_import() crea un nuevo objeto de gran tamaño en la base de datos utilizando un fichero en el sistema de ficheros como datos de origen.

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

Nota:

Anteriormente, esta función se llamaba pg_loimport().

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.

pathname

La ruta de acceso completa y el fichero desde el cual se leerá el objeto de gran tamaño en el sistema del cliente.

object_id

Si el argumento object_id es proporcionado, la función intentará crear un objeto grande con este identificador, de lo contrario, un identificador de objeto disponible será asignado por el servidor. Este argumento depende de una funcionalidad que apareció con PostgreSQL 8.1.

Valores devueltos

El OID del nuevo objeto de gran tamaño creado, 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_import()

<?php
$database
= pg_connect("dbname=jacarta");
pg_query($database, "begin");
$oid = pg_lo_import($database, '/tmp/lob.dat');
pg_query($database, "commit");
?>

Ver también