Импортирует большой объект из файла

# pg_lo_import

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_lo_import — Импортирует большой объект из файла

### Описание

function pg_lo_import(PgSql\Connection `$connection` = ?, string `$filename`, int|string `$oid` = ?): int|string|false

Функция pg_lo_import() создаёт большой объект в базе данных из локального файла.

Методы интерфейса больших объектов работают только внутри блока транзакций.

> Замечание:

> Раньше функция называлась pg_loimport().

### Список параметров

`connection`

  Экземпляр класса PgSql\Connection. Функция выберет соединение по умолчанию, если параметр `connection` не указали. Соединение по умолчанию — последнее соединение, которое установила функция pg_connect() или pg_pconnect().

  Внимание

  Начиная с PHP 8.1.0 выбор функцией соединения по умолчанию устарел.

`filename`

  Полный путь и название файла в клиентской файловой системе, из которого функция считает данные большого объекта.

`oid`

  При установке параметра `oid` функция попытается создать объект с этим идентификатором, иначе сервер назначит объекту свободный идентификатор. Параметр работает на основе механизма, который впервые появился в 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");

    ?>

### Смотрите также

- pg_lo_export() - Вывод большого объекта в файл
- pg_lo_open() - Открывает большой объект базы данных

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open