(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_lo_export — Вывод большого объекта в файл
pg_lo_export() выбирает большой объект из базы данных и сохраняет его данные локально в файловой системе.
Операции с использованием интерфейса больших объектов необходимо заключать в блок транзакции.
Замечание:
Прежнее название функции: pg_loexport().
connection
Экземпляр
класса PgSql\Connection.
Функция выберет соединение по умолчанию, если параметр connection
не указали.
Соединение по умолчанию — последнее соединение, которое установила функция pg_connect()
или pg_pconnect().
Начиная с PHP 8.1.0 выбор функцией соединения по умолчанию устарел.
oid
OID большого объекта в базе данных.
pathname
Полный путь и имя файла в клиентской файловой системе для записи данных большого объекта.
Функция возвращает true
в случае успешного выполнения или false
, если возникла ошибка.
Версия | Описание |
---|---|
8.1.0 |
Параметр connection теперь ожидает экземпляр
класса PgSql\Connection; раньше параметр ожидал ресурс (resource).
|
Пример #1 Пример использования 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, "large object data");
pg_lo_close($handle);
pg_lo_export($database, $oid, '/tmp/lob.dat');
pg_query($database, "commit");
?>