pg_lo_export
(PHP 4 >= 4.2.0, PHP 5)
pg_lo_export -- Export a large object to file
Description
bool
pg_lo_export ( resource connection, int oid, string pathname )
bool
pg_lo_export ( int oid, string pathname )
pg_lo_export() takes a large object in a
PostgreSQL database and saves its contents to a file on the local
filesystem.
To use the large object interface, it is necessary to
enclose it within a transaction block.
Note:
This function used to be called pg_loexport().
Parameters
- connection
PostgreSQL database connection resource. When
connection is not present, the default connection
is used. The default connection is the last connection made by
pg_connect() or pg_pconnect().
- oid
The OID of the large object in the database.
- pathname
The full path and file name of the file in which to write the
large object on the client filesystem.
Return Values
Returns TRUE on success or FALSE on failure.
Examples
Example 1. pg_lo_export() example
<?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, "large object data");
pg_lo_close($handle);
pg_lo_export($database, $oid, '/tmp/lob.dat');
pg_query($database, "commit");
?>
|
|