(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_lo_import — Importa un objeto de gran tamaño desde un fichero
$connection = ?, string $pathname, mixed $object_id = ?): int|string|falsepg_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().
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()
Desde PHP 8.1.0, usar la conexión por defecto está obsoleto.
pathnameLa 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.
El OID del nuevo objeto de gran tamaño creado, o false si ocurre un error.
| Versión | Descripción |
|---|---|
| 8.1.0 |
El parámetro connection ahora espera una instancia de
PgSql\Connection ; anteriormente, se esperaba un resource.
|
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");
?>