(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_lo_import — Импортирует большой объект из файла
$connection = ?, string $pathname, mixed $object_id = ?): int|string|falseФункция pg_lo_import() создаёт большой объект в базе данных из локального файла.
Методы интерфейса больших объектов работают только внутри блока транзакций.
Замечание:
Раньше функция называлась pg_loimport().
connectionЭкземпляр
класса PgSql\Connection.
Функция выберет соединение по умолчанию, если параметр connection не указали.
Соединение по умолчанию — последнее соединение, которое установила функция pg_connect()
или pg_pconnect().
Начиная с PHP 8.1.0 выбор функцией соединения по умолчанию устарел.
pathnameПолный путь и название файла в клиентской файловой системе, из которого функция считает данные большого объекта.
object_id
При установке параметра object_id функция
попытается создать объект с этим идентификатором,
иначе сервер назначит объекту свободный идентификатор.
Параметр работает на основе механизма,
который впервые появился в PostgreSQL 8.1.
Функция возвращает OID вновь созданного большого объекта или false, если возникла ошибка.
| Версия | Описание |
|---|---|
| 8.1.0 |
Параметр connection теперь ожидает экземпляр
класса PgSql\Connection; раньше параметр ожидал ресурс (resource).
|
Пример #1 Пример импорта большого объекта из файла функцией 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");
?>