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

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

An PgSql\Connection instance. When connection is unspecified, the default connection is used. The default connection is the last connection made by pg_connect() or pg_pconnect().

Advertencia

As of PHP 8.1.0, using the default connection is deprecated.

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 en caso de error.

Historial de cambios

Versión Descripción
8.1.0 The connection parameter expects an PgSql\Connection instance now; previously, a recurso was expected.

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